@tscircuit/cli 0.1.1052 → 0.1.1053

package/dist/cli/main.js

@@ -71664,7 +71664,7 @@ var registerStaticAssetLoaders = () => {
 // cli/main.ts
 var import_perfect_cli = __toESM2(require_dist2(), 1);
 // package.json
-var version = "0.1.1051";
+var version = "0.1.1052";
 var package_default = {
   name: "@tscircuit/cli",
   version,
@@ -81871,42 +81871,27 @@ var exitBuild = (code, reason) => {
 // cli/build/worker-pool.ts
 import fs36 from "node:fs";
 import path38 from "node:path";
+
+// lib/shared/thread-worker-pool.ts
 import { Worker } from "node:worker_threads";
-var getWorkerEntrypointPath = () => {
-  const tsPath = path38.join(import.meta.dir, "build-worker-entrypoint.ts");
-  if (fs36.existsSync(tsPath)) {
-    return tsPath;
-  }
-  const jsBundledPath = path38.join(import.meta.dir, "build", "build-worker-entrypoint.js");
-  if (fs36.existsSync(jsBundledPath)) {
-    return jsBundledPath;
-  }
-  return path38.join(import.meta.dir, "build-worker-entrypoint.js");
-};
 
-class WorkerPool {
+class ThreadWorkerPool {
   workers = [];
   jobQueue = [];
   concurrency;
-  onLog;
-  workerEntrypointPath;
+  options;
   initialized = false;
   stopped = false;
   stopReason = null;
-  stopOnFatal = false;
-  cancellationError = null;
   constructor(options) {
+    this.options = options;
     this.concurrency = options.concurrency;
-    this.onLog = options.onLog;
-    this.workerEntrypointPath = getWorkerEntrypointPath();
-    this.stopOnFatal = options.stopOnFatal ?? false;
-    this.cancellationError = options.cancellationError ?? null;
   }
   async initWorkers() {
     if (this.initialized)
       return;
     for (let i = 0;i < this.concurrency; i++) {
-      const worker = new Worker(this.workerEntrypointPath);
+      const worker = new Worker(this.options.workerEntrypointPath);
       const threadWorker = {
         worker,
         busy: false,
@@ -81920,38 +81905,24 @@ class WorkerPool {
   }
   setupWorkerMessageHandling(threadWorker) {
     threadWorker.worker.on("message", (message) => {
-      if (message.message_type === "worker_log") {
-        const logMsg = message;
-        if (this.onLog) {
-          this.onLog(logMsg.log_lines);
-        }
-      } else if (message.message_type === "build_completed") {
-        const completedMsg = message;
-        const job = threadWorker.currentJob;
-        if (job) {
-          if (this.stopOnFatal && completedMsg.isFatalError && this.cancellationError) {
-            this.stop(this.cancellationError);
-          }
-          job.resolve({
-            filePath: completedMsg.file_path,
-            outputPath: completedMsg.output_path,
-            glbOutputPath: completedMsg.glb_output_path,
-            previewOutputDir: completedMsg.preview_output_dir,
-            glbOk: completedMsg.glb_ok,
-            glbError: completedMsg.glb_error,
-            previewOk: completedMsg.preview_ok,
-            previewError: completedMsg.preview_error,
-            ok: completedMsg.ok,
-            isFatalError: completedMsg.isFatalError,
-            errors: completedMsg.errors,
-            warnings: completedMsg.warnings,
-            durationMs: completedMsg.durationMs
-          });
-          threadWorker.currentJob = null;
-          threadWorker.busy = false;
-          this.processQueue();
-        }
+      if (this.options.isLogMessage(message)) {
+        this.options.onLog?.(this.options.getLogLines(message));
+        return;
+      }
+      if (!this.options.isCompletionMessage(message)) {
+        return;
       }
+      const job = threadWorker.currentJob;
+      if (!job) {
+        return;
+      }
+      if (this.options.shouldStopOnMessage?.(message) && this.options.cancellationError) {
+        this.stop(this.options.cancellationError);
+      }
+      job.resolve(this.options.getResult(message));
+      threadWorker.currentJob = null;
+      threadWorker.busy = false;
+      this.processQueue();
     });
   }
   setupWorkerErrorHandling(threadWorker) {
@@ -81961,11 +81932,9 @@ class WorkerPool {
         threadWorker.currentJob = null;
         threadWorker.busy = false;
       }
-      if (this.onLog) {
-        this.onLog([
-          `Worker error: ${error instanceof Error ? error.message : String(error)}`
-        ]);
-      }
+      this.options.onLog?.([
+        `Worker error: ${error instanceof Error ? error.message : String(error)}`
+      ]);
     });
     threadWorker.worker.on("exit", (code) => {
       if (code !== 0 && threadWorker.currentJob) {
@@ -81976,28 +81945,20 @@ class WorkerPool {
     });
   }
   processQueue() {
-    if (this.stopped)
+    if (this.stopped || this.jobQueue.length === 0) {
       return;
-    if (this.jobQueue.length === 0)
-      return;
-    const availableWorker = this.workers.find((w) => !w.busy);
-    if (!availableWorker)
+    }
+    const availableWorker = this.workers.find((worker) => !worker.busy);
+    if (!availableWorker) {
       return;
-    const job = this.jobQueue.shift();
-    if (!job)
+    }
+    const queuedJob = this.jobQueue.shift();
+    if (!queuedJob) {
       return;
+    }
     availableWorker.busy = true;
-    availableWorker.currentJob = job;
-    const message = {
-      message_type: "build_file",
-      file_path: job.filePath,
-      output_path: job.outputPath,
-      glb_output_path: job.glbOutputPath,
-      preview_output_dir: job.previewOutputDir,
-      project_dir: job.projectDir,
-      options: job.options
-    };
-    availableWorker.worker.postMessage(message);
+    availableWorker.currentJob = queuedJob;
+    availableWorker.worker.postMessage(this.options.createMessage(queuedJob.job));
   }
   async queueJob(job) {
     if (this.stopped) {
@@ -82005,12 +81966,7 @@ class WorkerPool {
     }
     await this.initWorkers();
     return new Promise((resolve4, reject) => {
-      const queuedJob = {
-        ...job,
-        resolve: resolve4,
-        reject
-      };
-      this.jobQueue.push(queuedJob);
+      this.jobQueue.push({ job, resolve: resolve4, reject });
       this.processQueue();
     });
   }
@@ -82024,35 +81980,70 @@ class WorkerPool {
     }
     this.jobQueue = [];
   }
-  async runUntilComplete() {
-    return new Promise((resolve4) => {
-      const checkComplete = () => {
-        const allIdle = this.workers.every((w) => !w.busy);
-        const queueEmpty = this.jobQueue.length === 0;
-        if (allIdle && queueEmpty) {
-          resolve4();
-        } else {
-          setTimeout(checkComplete, 50);
-        }
-      };
-      checkComplete();
-    });
-  }
   async terminate() {
-    const terminatePromises = this.workers.map((w) => w.worker.terminate());
-    await Promise.all(terminatePromises);
+    await Promise.all(this.workers.map((worker) => worker.worker.terminate()));
     this.workers = [];
     this.initialized = false;
   }
 }
+
+// cli/build/worker-pool.ts
+var getWorkerEntrypointPath = () => {
+  const tsPath = path38.join(import.meta.dir, "build.worker.ts");
+  if (fs36.existsSync(tsPath)) {
+    return tsPath;
+  }
+  const jsBundledPath = path38.join(import.meta.dir, "build", "build.worker.js");
+  if (fs36.existsSync(jsBundledPath)) {
+    return jsBundledPath;
+  }
+  return path38.join(import.meta.dir, "build.worker.js");
+};
 async function buildFilesWithWorkerPool(options) {
   const cancellationError = new Error("Build cancelled due fatal error");
   const poolConcurrency = Math.max(1, Math.min(options.concurrency, options.files.length));
-  const pool = new WorkerPool({
+  const pool = new ThreadWorkerPool({
     concurrency: poolConcurrency,
-    onLog: options.onLog,
-    stopOnFatal: options.stopOnFatal,
-    cancellationError
+    workerEntrypointPath: getWorkerEntrypointPath(),
+    createMessage: (job) => ({
+      message_type: "build_file",
+      file_path: job.filePath,
+      output_path: job.outputPath,
+      glb_output_path: job.glbOutputPath,
+      preview_output_dir: job.previewOutputDir,
+      project_dir: job.projectDir,
+      options: job.options
+    }),
+    isLogMessage: (message) => message.message_type === "worker_log",
+    getLogLines: (message) => message.message_type === "worker_log" ? message.log_lines : [],
+    isCompletionMessage: (message) => message.message_type === "build_completed",
+    getResult: (message) => {
+      const completedMessage = message;
+      return {
+        filePath: completedMessage.file_path,
+        outputPath: completedMessage.output_path,
+        glbOutputPath: completedMessage.glb_output_path,
+        previewOutputDir: completedMessage.preview_output_dir,
+        glbOk: completedMessage.glb_ok,
+        glbError: completedMessage.glb_error,
+        previewOk: completedMessage.preview_ok,
+        previewError: completedMessage.preview_error,
+        ok: completedMessage.ok,
+        hasErrors: completedMessage.hasErrors,
+        isFatalError: completedMessage.isFatalError,
+        errors: completedMessage.errors,
+        warnings: completedMessage.warnings,
+        durationMs: completedMessage.durationMs
+      };
+    },
+    shouldStopOnMessage: (message) => {
+      if (!options.stopOnFatal || message.message_type !== "build_completed") {
+        return false;
+      }
+      return Boolean(message.isFatalError);
+    },
+    cancellationError,
+    onLog: options.onLog
   });
   const results = [];
   const promises = [];
@@ -177560,8 +177551,89 @@ function applyCameraPreset(preset, cam) {
 }
 
 // lib/shared/snapshot-project.ts
-import fs61 from "node:fs";
+import path64 from "node:path";
+
+// cli/snapshot/worker-pool.ts
+import fs60 from "node:fs";
 import path62 from "node:path";
+var getWorkerEntrypointPath2 = () => {
+  const tsPath = path62.join(import.meta.dir, "snapshot.worker.ts");
+  if (fs60.existsSync(tsPath)) {
+    return tsPath;
+  }
+  const jsBundledPath = path62.join(import.meta.dir, "snapshot", "snapshot.worker.js");
+  if (fs60.existsSync(jsBundledPath)) {
+    return jsBundledPath;
+  }
+  return path62.join(import.meta.dir, "snapshot.worker.js");
+};
+var snapshotFilesWithWorkerPool = async (options) => {
+  const cancellationError = new Error("Snapshot cancelled due to file failure");
+  const poolConcurrency = Math.max(1, Math.min(options.concurrency, options.files.length));
+  const pool = new ThreadWorkerPool({
+    concurrency: poolConcurrency,
+    workerEntrypointPath: getWorkerEntrypointPath2(),
+    createMessage: (job) => ({
+      message_type: "snapshot_file",
+      file_path: job.filePath,
+      project_dir: job.projectDir,
+      snapshots_dir_name: job.snapshotsDirName,
+      options: {
+        update: job.options.update,
+        threeD: job.options.threeD,
+        pcbOnly: job.options.pcbOnly,
+        schematicOnly: job.options.schematicOnly,
+        forceUpdate: job.options.forceUpdate,
+        platformConfig: job.options.platformConfig,
+        createDiff: job.options.createDiff,
+        cameraPreset: job.options.cameraPreset
+      }
+    }),
+    isLogMessage: (message) => message.message_type === "worker_log",
+    getLogLines: (message) => message.message_type === "worker_log" ? message.log_lines : [],
+    isCompletionMessage: (message) => message.message_type === "snapshot_completed",
+    getResult: (message) => {
+      const completedMessage = message;
+      return {
+        filePath: completedMessage.file_path,
+        result: completedMessage.result
+      };
+    },
+    shouldStopOnMessage: (message) => {
+      if (!options.stopOnFailure || message.message_type !== "snapshot_completed") {
+        return false;
+      }
+      return !message.result.ok;
+    },
+    cancellationError,
+    onLog: options.onLog
+  });
+  const results = [];
+  const jobs = options.files.map((filePath) => pool.queueJob({
+    filePath,
+    projectDir: options.projectDir,
+    snapshotsDirName: options.snapshotsDirName,
+    options: options.snapshotOptions
+  }).then(async (result) => {
+    results.push(result);
+    await options.onJobComplete?.(result);
+    return result;
+  }));
+  const settledResults = await Promise.allSettled(jobs);
+  for (const settledResult of settledResults) {
+    if (settledResult.status === "rejected" && settledResult.reason !== cancellationError) {
+      throw settledResult.reason;
+    }
+  }
+  if (typeof Bun === "undefined") {
+    await pool.terminate();
+  }
+  return results;
+};
+
+// lib/shared/process-snapshot-file.ts
+import fs62 from "node:fs";
+import path63 from "node:path";
 import {
   convertCircuitJsonToGltf as convertCircuitJsonToGltf5,
   getBestCameraPosition
@@ -177570,12 +177642,11 @@ import {
   convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg3,
   convertCircuitJsonToSchematicSvg as convertCircuitJsonToSchematicSvg3
 } from "circuit-to-svg";
-import looksSame2 from "looks-same";
 import { renderGLTFToPNGBufferFromGLBBuffer as renderGLTFToPNGBufferFromGLBBuffer2 } from "poppygl";
 
 // lib/shared/compare-images.ts
 import looksSame from "looks-same";
-import fs60 from "node:fs/promises";
+import fs61 from "node:fs/promises";
 var compareAndCreateDiff = async (buffer1, buffer2, diffPath, createDiff = true) => {
   const { equal: equal2 } = await looksSame(buffer1, buffer2, {
     strict: false,
@@ -177591,12 +177662,200 @@ var compareAndCreateDiff = async (buffer1, buffer2, diffPath, createDiff = true)
         tolerance: 2
       });
     } else {
-      await fs60.writeFile(diffPath, buffer2);
+      await fs61.writeFile(diffPath, buffer2);
     }
   }
   return { equal: equal2 };
 };
 
+// lib/shared/process-snapshot-file.ts
+var isCircuitJsonFile = (filePath) => {
+  const normalizedPath = filePath.toLowerCase().replaceAll("\\", "/");
+  return normalizedPath.endsWith(".circuit.json") || normalizedPath.endsWith("/circuit.json");
+};
+var processSnapshotFile = async ({
+  file,
+  projectDir,
+  snapshotsDirName,
+  update,
+  threeD,
+  pcbOnly,
+  schematicOnly,
+  forceUpdate,
+  platformConfig: platformConfig2,
+  createDiff,
+  cameraPreset
+}) => {
+  const relativeFilePath = path63.relative(projectDir, file);
+  const successPaths = [];
+  const warningMessages = [];
+  const mismatches = [];
+  let didUpdate = false;
+  let circuitJson;
+  let pcbSvg;
+  let schSvg;
+  try {
+    if (isCircuitJsonFile(file)) {
+      const parsed = JSON.parse(fs62.readFileSync(file, "utf-8"));
+      circuitJson = Array.isArray(parsed) ? parsed : [];
+    } else {
+      const completePlatformConfig = getCompletePlatformConfig(platformConfig2);
+      const result = await generateCircuitJson({
+        filePath: file,
+        platformConfig: completePlatformConfig
+      });
+      circuitJson = result.circuitJson;
+    }
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      ok: false,
+      didUpdate: false,
+      successPaths,
+      warningMessages,
+      mismatches,
+      errorMessage: kleur_default.red(`
+❌ Failed to generate circuit JSON for ${relativeFilePath}:
+`) + kleur_default.red(`   ${errorMessage}
+`)
+    };
+  }
+  try {
+    pcbSvg = convertCircuitJsonToPcbSvg3(circuitJson);
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      ok: false,
+      didUpdate: false,
+      successPaths,
+      warningMessages,
+      mismatches,
+      errorMessage: kleur_default.red(`
+❌ Failed to generate PCB SVG for ${relativeFilePath}:
+`) + kleur_default.red(`   ${errorMessage}
+`)
+    };
+  }
+  try {
+    schSvg = convertCircuitJsonToSchematicSvg3(circuitJson);
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      ok: false,
+      didUpdate: false,
+      successPaths,
+      warningMessages,
+      mismatches,
+      errorMessage: kleur_default.red(`
+❌ Failed to generate schematic SVG for ${relativeFilePath}:
+`) + kleur_default.red(`   ${errorMessage}
+`)
+    };
+  }
+  let png3d = null;
+  if (threeD) {
+    try {
+      const glbBuffer = await convertCircuitJsonToGltf5(circuitJson, getCircuitJsonToGltfOptions({ format: "glb" }));
+      if (!(glbBuffer instanceof ArrayBuffer)) {
+        throw new Error("Expected ArrayBuffer from convertCircuitJsonToGltf with glb format");
+      }
+      let cameraOptions = getBestCameraPosition(circuitJson);
+      if (cameraPreset) {
+        cameraOptions = applyCameraPreset(cameraPreset, cameraOptions);
+      }
+      png3d = await renderGLTFToPNGBufferFromGLBBuffer2(glbBuffer, cameraOptions);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      if (errorMessage.includes("No pcb_board found in circuit JSON")) {
+        const fileDir = path63.dirname(file);
+        const relativeDir = path63.relative(projectDir, fileDir);
+        const snapDir2 = snapshotsDirName ? path63.join(projectDir, snapshotsDirName, relativeDir) : path63.join(fileDir, "__snapshots__");
+        const base2 = path63.basename(file).replace(/\.[^.]+$/, "");
+        const snap3dPath = path63.join(snapDir2, `${base2}-3d.snap.png`);
+        const existing3dSnapshot = fs62.existsSync(snap3dPath);
+        if (existing3dSnapshot) {
+          return {
+            ok: false,
+            didUpdate: false,
+            successPaths,
+            warningMessages,
+            mismatches,
+            errorMessage: kleur_default.red(`
+❌ Failed to generate 3D snapshot for ${relativeFilePath}:
+`) + kleur_default.red(`   No pcb_board found in circuit JSON
+`) + kleur_default.red(`   Existing snapshot: ${path63.relative(projectDir, snap3dPath)}
+`)
+          };
+        }
+        warningMessages.push(kleur_default.red(`⚠️  Skipping 3D snapshot for ${relativeFilePath}:`) + kleur_default.red(` No pcb_board found in circuit JSON`));
+        png3d = null;
+      } else {
+        return {
+          ok: false,
+          didUpdate: false,
+          successPaths,
+          warningMessages,
+          mismatches,
+          errorMessage: kleur_default.red(`
+❌ Failed to generate 3D snapshot for ${relativeFilePath}:
+`) + kleur_default.red(`   ${errorMessage}
+`)
+        };
+      }
+    }
+  }
+  const snapDir = snapshotsDirName ? path63.join(projectDir, snapshotsDirName, path63.relative(projectDir, path63.dirname(file))) : path63.join(path63.dirname(file), "__snapshots__");
+  fs62.mkdirSync(snapDir, { recursive: true });
+  const base = path63.basename(file).replace(/\.[^.]+$/, "");
+  const snapshots = [];
+  if (pcbOnly || !schematicOnly) {
+    snapshots.push({ type: "pcb", content: pcbSvg, isBinary: false });
+  }
+  if (schematicOnly || !pcbOnly) {
+    snapshots.push({ type: "schematic", content: schSvg, isBinary: false });
+  }
+  if (threeD && png3d) {
+    snapshots.push({ type: "3d", content: png3d, isBinary: true });
+  }
+  for (const snapshot of snapshots) {
+    const { type } = snapshot;
+    const is3d = type === "3d";
+    const snapPath = path63.join(snapDir, `${base}-${type}.snap.${is3d ? "png" : "svg"}`);
+    const existing = fs62.existsSync(snapPath);
+    const newContentBuffer = snapshot.isBinary ? snapshot.content : Buffer.from(snapshot.content, "utf8");
+    const newContentForFile = snapshot.content;
+    if (!existing) {
+      fs62.writeFileSync(snapPath, newContentForFile);
+      successPaths.push(path63.relative(projectDir, snapPath));
+      didUpdate = true;
+      continue;
+    }
+    const oldContentBuffer = fs62.readFileSync(snapPath);
+    const diffPath = snapPath.replace(is3d ? ".snap.png" : ".snap.svg", is3d ? ".diff.png" : ".diff.svg");
+    const { equal: equal2 } = await compareAndCreateDiff(oldContentBuffer, newContentBuffer, diffPath, createDiff);
+    if (update) {
+      if (!forceUpdate && equal2) {
+        successPaths.push(path63.relative(projectDir, snapPath));
+      } else {
+        fs62.writeFileSync(snapPath, newContentForFile);
+        successPaths.push(path63.relative(projectDir, snapPath));
+        didUpdate = true;
+      }
+    } else if (!equal2) {
+      mismatches.push(createDiff ? `${snapPath} (diff: ${diffPath})` : snapPath);
+    } else {
+      successPaths.push(path63.relative(projectDir, snapPath));
+    }
+  }
+  return {
+    ok: true,
+    didUpdate,
+    successPaths,
+    warningMessages,
+    mismatches
+  };
+};
+
 // lib/shared/snapshot-project.ts
 var snapshotProject = async ({
   update = false,
@@ -177611,7 +177870,8 @@ var snapshotProject = async ({
   onSuccess = (msg) => console.log(msg),
   platformConfig: platformConfig2,
   createDiff = false,
-  cameraPreset
+  cameraPreset,
+  concurrency = 1
 } = {}) => {
   if (cameraPreset) {
     threeD = true;
@@ -177621,7 +177881,7 @@ var snapshotProject = async ({
     ...DEFAULT_IGNORED_PATTERNS,
     ...ignored.map(normalizeIgnorePattern)
   ];
-  const resolvedPaths = filePaths.map((f2) => path62.resolve(projectDir, f2));
+  const resolvedPaths = filePaths.map((f2) => path64.resolve(projectDir, f2));
   const boardFiles = findBoardFiles({
     projectDir,
     ignore,
@@ -177634,141 +177894,78 @@ var snapshotProject = async ({
   const snapshotsDirName = getSnapshotsDir(projectDir);
   const mismatches = [];
   let didUpdate = false;
-  const isCircuitJsonFile = (filePath) => {
-    const normalizedPath = filePath.toLowerCase().replaceAll("\\", "/");
-    return normalizedPath.endsWith(".circuit.json") || normalizedPath.endsWith("/circuit.json");
-  };
-  for (const file of boardFiles) {
-    const relativeFilePath = path62.relative(projectDir, file);
-    let circuitJson;
-    let pcbSvg;
-    let schSvg;
-    try {
-      if (isCircuitJsonFile(file)) {
-        const parsed = JSON.parse(fs61.readFileSync(file, "utf-8"));
-        circuitJson = Array.isArray(parsed) ? parsed : [];
-      } else {
-        const completePlatformConfig = getCompletePlatformConfig(platformConfig2);
-        const result = await generateCircuitJson({
-          filePath: file,
-          platformConfig: completePlatformConfig
-        });
-        circuitJson = result.circuitJson;
-      }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      onError(kleur_default.red(`
-❌ Failed to generate circuit JSON for ${relativeFilePath}:
-`) + kleur_default.red(`   ${errorMessage}
-`));
-      return onExit2(1);
+  const concurrencyValue = Math.max(1, concurrency);
+  const processResult = (result) => {
+    for (const warningMessage of result.warningMessages) {
+      console.log(warningMessage);
     }
-    try {
-      pcbSvg = convertCircuitJsonToPcbSvg3(circuitJson);
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      onError(kleur_default.red(`
-❌ Failed to generate PCB SVG for ${relativeFilePath}:
-`) + kleur_default.red(`   ${errorMessage}
-`));
-      return onExit2(1);
+    for (const successPath of result.successPaths) {
+      console.log("✅", kleur_default.gray(successPath));
     }
+    didUpdate = didUpdate || result.didUpdate;
+    mismatches.push(...result.mismatches);
+  };
+  if (concurrencyValue > 1 && boardFiles.length > 1) {
+    console.log(`Generating snapshots for ${boardFiles.length} file(s) with concurrency ${concurrencyValue}...`);
+    let firstErrorMessage;
     try {
-      schSvg = convertCircuitJsonToSchematicSvg3(circuitJson);
+      await snapshotFilesWithWorkerPool({
+        files: boardFiles,
+        projectDir,
+        snapshotsDirName,
+        concurrency: concurrencyValue,
+        snapshotOptions: {
+          update,
+          threeD,
+          pcbOnly,
+          schematicOnly,
+          forceUpdate,
+          platformConfig: platformConfig2,
+          createDiff,
+          cameraPreset
+        },
+        stopOnFailure: true,
+        onLog: (lines) => {
+          for (const line2 of lines) {
+            console.log(line2);
+          }
+        },
+        onJobComplete: (jobResult) => {
+          const { result } = jobResult;
+          processResult(result);
+          if (!result.ok && !firstErrorMessage) {
+            firstErrorMessage = result.errorMessage ?? "Snapshot generation failed";
+          }
+        }
+      });
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      onError(kleur_default.red(`
-❌ Failed to generate schematic SVG for ${relativeFilePath}:
-`) + kleur_default.red(`   ${errorMessage}
-`));
+      onError(kleur_default.red(errorMessage));
       return onExit2(1);
     }
-    let png3d = null;
-    if (threeD) {
-      try {
-        const glbBuffer = await convertCircuitJsonToGltf5(circuitJson, getCircuitJsonToGltfOptions({ format: "glb" }));
-        if (!(glbBuffer instanceof ArrayBuffer)) {
-          throw new Error("Expected ArrayBuffer from convertCircuitJsonToGltf with glb format");
-        }
-        let cameraOptions = getBestCameraPosition(circuitJson);
-        if (cameraPreset) {
-          cameraOptions = applyCameraPreset(cameraPreset, cameraOptions);
-        }
-        png3d = await renderGLTFToPNGBufferFromGLBBuffer2(glbBuffer, cameraOptions);
-      } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        if (errorMessage.includes("No pcb_board found in circuit JSON")) {
-          const fileDir = path62.dirname(file);
-          const relativeDir = path62.relative(projectDir, fileDir);
-          const snapDir2 = snapshotsDirName ? path62.join(projectDir, snapshotsDirName, relativeDir) : path62.join(fileDir, "__snapshots__");
-          const base2 = path62.basename(file).replace(/\.[^.]+$/, "");
-          const snap3dPath = path62.join(snapDir2, `${base2}-3d.snap.png`);
-          const existing3dSnapshot = fs61.existsSync(snap3dPath);
-          if (existing3dSnapshot) {
-            onError(kleur_default.red(`
-❌ Failed to generate 3D snapshot for ${relativeFilePath}:
-`) + kleur_default.red(`   No pcb_board found in circuit JSON
-`) + kleur_default.red(`   Existing snapshot: ${path62.relative(projectDir, snap3dPath)}
-`));
-            return onExit2(1);
-          } else {
-            console.log(kleur_default.red(`⚠️  Skipping 3D snapshot for ${relativeFilePath}:`) + kleur_default.red(` No pcb_board found in circuit JSON`));
-            png3d = null;
-          }
-        } else {
-          onError(kleur_default.red(`
-❌ Failed to generate 3D snapshot for ${relativeFilePath}:
-`) + kleur_default.red(`   ${errorMessage}
-`));
-          return onExit2(1);
-        }
-      }
-    }
-    const snapDir = snapshotsDirName ? path62.join(projectDir, snapshotsDirName, path62.relative(projectDir, path62.dirname(file))) : path62.join(path62.dirname(file), "__snapshots__");
-    fs61.mkdirSync(snapDir, { recursive: true });
-    const base = path62.basename(file).replace(/\.[^.]+$/, "");
-    const snapshots = [];
-    if (pcbOnly || !schematicOnly) {
-      snapshots.push({ type: "pcb", content: pcbSvg, isBinary: false });
-    }
-    if (schematicOnly || !pcbOnly) {
-      snapshots.push({ type: "schematic", content: schSvg, isBinary: false });
-    }
-    if (threeD && png3d) {
-      snapshots.push({ type: "3d", content: png3d, isBinary: true });
-    }
-    if (!looksSame2) {
-      console.error("looks-same is required. Install it with 'bun add -d looks-same'");
+    if (firstErrorMessage) {
+      onError(firstErrorMessage);
       return onExit2(1);
     }
-    for (const snapshot of snapshots) {
-      const { type } = snapshot;
-      const is3d = type === "3d";
-      const snapPath = path62.join(snapDir, `${base}-${type}.snap.${is3d ? "png" : "svg"}`);
-      const existing = fs61.existsSync(snapPath);
-      const newContentBuffer = snapshot.isBinary ? snapshot.content : Buffer.from(snapshot.content, "utf8");
-      const newContentForFile = snapshot.content;
-      if (!existing) {
-        fs61.writeFileSync(snapPath, newContentForFile);
-        console.log("✅", kleur_default.gray(path62.relative(projectDir, snapPath)));
-        didUpdate = true;
-        continue;
-      }
-      const oldContentBuffer = fs61.readFileSync(snapPath);
-      const diffPath = snapPath.replace(is3d ? ".snap.png" : ".snap.svg", is3d ? ".diff.png" : ".diff.svg");
-      const { equal: equal2 } = await compareAndCreateDiff(oldContentBuffer, newContentBuffer, diffPath, createDiff);
-      if (update) {
-        if (!forceUpdate && equal2) {
-          console.log("✅", kleur_default.gray(path62.relative(projectDir, snapPath)));
-        } else {
-          fs61.writeFileSync(snapPath, newContentForFile);
-          console.log("✅", kleur_default.gray(path62.relative(projectDir, snapPath)));
-          didUpdate = true;
-        }
-      } else if (!equal2) {
-        mismatches.push(createDiff ? `${snapPath} (diff: ${diffPath})` : snapPath);
-      } else {
-        console.log("✅", kleur_default.gray(path62.relative(projectDir, snapPath)));
+  } else {
+    for (const file of boardFiles) {
+      const result = await processSnapshotFile({
+        file,
+        projectDir,
+        snapshotsDirName,
+        update,
+        threeD,
+        pcbOnly,
+        schematicOnly,
+        forceUpdate,
+        platformConfig: platformConfig2,
+        createDiff,
+        cameraPreset
+      });
+      processResult(result);
+      if (!result.ok) {
+        onError(result.errorMessage ?? "Snapshot generation failed");
+        return onExit2(1);
       }
     }
   }
@@ -177790,12 +177987,13 @@ Run with --update to fix.`);
 
 // cli/snapshot/register.ts
 var registerSnapshot = (program3) => {
-  program3.command("snapshot").argument("[path]", "Path to file, directory, or glob pattern (e.g., 'examples/**/*.tsx')").description("Generate schematic and PCB snapshots (add --3d for 3d preview)").option("-u, --update", "Update snapshots on disk").option("--force-update", "Force update snapshots even if they match").option("--3d", "Generate 3d preview snapshots").option("--pcb-only", "Generate only PCB snapshots").option("--schematic-only", "Generate only schematic snapshots").option("--disable-parts-engine", "Disable the parts engine").option("--camera-preset <preset>", `Camera angle preset for 3D snapshots (implies --3d). Valid presets: ${CAMERA_PRESET_NAMES.join(", ")}`).option("--ci", "Enable CI mode with snapshot diff artifacts").option("--test", "Enable test mode with snapshot diff artifacts").action(async (target, options) => {
+  program3.command("snapshot").argument("[path]", "Path to file, directory, or glob pattern (e.g., 'examples/**/*.tsx')").description("Generate schematic and PCB snapshots (add --3d for 3d preview)").option("-u, --update", "Update snapshots on disk").option("--force-update", "Force update snapshots even if they match").option("--3d", "Generate 3d preview snapshots").option("--pcb-only", "Generate only PCB snapshots").option("--schematic-only", "Generate only schematic snapshots").option("--disable-parts-engine", "Disable the parts engine").option("--camera-preset <preset>", `Camera angle preset for 3D snapshots (implies --3d). Valid presets: ${CAMERA_PRESET_NAMES.join(", ")}`).option("--ci", "Enable CI mode with snapshot diff artifacts").option("--test", "Enable test mode with snapshot diff artifacts").option("--concurrency <number>", "Number of files to snapshot in parallel (default: 1)", "1").action(async (target, options) => {
     if (options.cameraPreset && !CAMERA_PRESET_NAMES.includes(options.cameraPreset)) {
       console.error(`Unknown camera preset "${options.cameraPreset}". Valid presets: ${CAMERA_PRESET_NAMES.join(", ")}`);
       process.exit(1);
     }
     await snapshotProject({
+      concurrency: Math.max(1, Number.parseInt(options.concurrency || "1", 10)),
       update: options.update ?? false,
       threeD: options["3d"] ?? false,
       pcbOnly: options.pcbOnly ?? false,
@@ -177813,7 +178011,7 @@ var registerSnapshot = (program3) => {
 };
 
 // cli/transpile/register.ts
-import path63 from "node:path";
+import path65 from "node:path";
 var registerTranspile = (program3) => {
   program3.command("transpile").description("Transpile TypeScript/TSX to JavaScript (ESM, CommonJS, and type declarations)").argument("[file]", "Path to the entry file").action(async (file) => {
     try {
@@ -177821,7 +178019,7 @@ var registerTranspile = (program3) => {
         fileOrDir: file,
         includeBoardFiles: false
       });
-      const distDir = path63.join(projectDir, "dist");
+      const distDir = path65.join(projectDir, "dist");
       validateMainInDist(projectDir, distDir);
       console.log("Transpiling entry file...");
       const entryFile = mainEntrypoint || circuitFiles[0];