npm - @tscircuit/cli - Versions diffs - 0.1.975 → 0.1.976 - Mend

@tscircuit/cli 0.1.975 → 0.1.976

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/cli/main.js CHANGED Viewed

@@ -74395,7 +74395,7 @@ var getGlobalDepsInstallCommand = (packageManager, deps) => {
 import { execSync as execSync2 } from "node:child_process";
 var import_semver2 = __toESM2(require_semver2(), 1);
 // package.json
-var version = "0.1.974";
+var version = "0.1.975";
 var package_default = {
   name: "@tscircuit/cli",
   main: "dist/cli/main.js",
@@ -174470,202 +174470,89 @@ var registerRemove = (program3) => {
 };
 // cli/build/register.ts
-import path55 from "node:path";
 import fs54 from "node:fs";
+import path55 from "node:path";
-// cli/build/build-file.ts
-import path42 from "node:path";
-import fs42 from "node:fs";
+// lib/site/getStaticIndexHtmlFile.ts
+var getStaticIndexHtmlFile = ({
+  files,
+  standaloneScriptSrc = "./standalone.min.js",
+  defaultMainComponentPath,
+  packageName
+}) => {
+  const scriptLines = [
+    "window.TSCIRCUIT_USE_RUNFRAME_FOR_CLI = false;",
+    `window.TSCIRCUIT_RUNFRAME_STATIC_FILE_LIST = ${JSON.stringify(files)};`,
+    ...defaultMainComponentPath ? [
+      `window.TSCIRCUIT_DEFAULT_MAIN_COMPONENT_PATH = ${JSON.stringify(defaultMainComponentPath)};`
+    ] : [],
+    ...packageName ? [`window.TSCIRCUIT_PACKAGE_NAME = ${JSON.stringify(packageName)};`] : []
+  ];
+  const scriptBlock = `      <script>
+        ${scriptLines.join(`
+        `)}
+      </script>
+`;
+  return `<html>
+    <head>
+      <link rel="icon" type="image/png" href="https://github.com/tscircuit.png">
+      <meta charset="UTF-8" />
+      <title>tscircuit</title>
+      <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    </head>
+    <body>
+${scriptBlock}      <script src="https://cdn.tailwindcss.com"></script>
+      <div id="root">loading...</div>
+      <script>
+      globalThis.process = { env: { NODE_ENV: "production" } }
+      </script>
+      <script type="module" src="${standaloneScriptSrc}"></script>
+    </body>
+  </html>`;
+};
-// lib/shared/circuit-json-diagnostics.ts
-function analyzeCircuitJson(circuitJson) {
-  const errors = [];
-  const warnings = [];
-  for (const item of circuitJson) {
-    if (!item || typeof item !== "object")
-      continue;
-    const t3 = item.type;
-    if (typeof t3 === "string") {
-      if (t3.endsWith("_error"))
-        errors.push(item);
-      else if (t3.endsWith("_warning"))
-        warnings.push(item);
-    }
-    if ("error_type" in item)
-      errors.push(item);
-    if ("warning_type" in item)
-      warnings.push(item);
+// cli/utils/get-latest-tscircuit-cdn-url.ts
+var TSCIRCUIT_NPMJS_API_URL = "https://registry.npmjs.org/tscircuit/latest";
+async function getLatestTscircuitCdnVersion() {
+  const response = await fetch(TSCIRCUIT_NPMJS_API_URL);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch tscircuit version from CDN: ${response.statusText}`);
   }
-  return { errors, warnings };
-}
-// lib/shared/get-complete-platform-config.ts
-import { getPlatformConfig } from "@tscircuit/eval/platform-config";
-import { createHash } from "node:crypto";
-import path41 from "node:path";
-import fs41 from "node:fs";
-function createLocalCacheEngine(cacheDir = path41.join(process.cwd(), ".tscircuit", "cache")) {
-  return {
-    getItem: (key) => {
-      try {
-        const hash = createHash("md5").update(key).digest("hex");
-        const keyWithSafeCharacters = key.replace(/[^a-zA-Z0-9]/g, "_");
-        const filePath = path41.join(cacheDir, `${keyWithSafeCharacters.slice(keyWithSafeCharacters.length - 10, keyWithSafeCharacters.length)}-${hash}.json`);
-        return fs41.readFileSync(filePath, "utf-8");
-      } catch {
-        return null;
-      }
-    },
-    setItem: (key, value) => {
-      try {
-        fs41.mkdirSync(cacheDir, { recursive: true });
-        const hash = createHash("md5").update(key).digest("hex");
-        const keyWithSafeCharacters = key.replace(/[^a-zA-Z0-9]/g, "_");
-        const filePath = path41.join(cacheDir, `${keyWithSafeCharacters.slice(keyWithSafeCharacters.length - 10, keyWithSafeCharacters.length)}-${hash}.json`);
-        fs41.writeFileSync(filePath, value);
-      } catch {}
-    }
-  };
+  const data = await response.json();
+  return data.version;
 }
-function getCompletePlatformConfig(userConfig) {
-  const basePlatformConfig = getPlatformConfig();
-  const defaultConfig = {
-    ...basePlatformConfig,
-    localCacheEngine: createLocalCacheEngine(),
-    footprintFileParserMap: {
-      ...basePlatformConfig.footprintFileParserMap,
-      kicad_mod: {
-        loadFromUrl: async (url) => {
-          let fetchUrl = url;
-          if (url.startsWith("./") || url.startsWith("../")) {
-            const absolutePath = path41.resolve(process.cwd(), url);
-            fetchUrl = `file://${absolutePath}`;
-          } else if (url.startsWith("/")) {
-            if (fs41.existsSync(url)) {
-              fetchUrl = `file://${url}`;
-            } else {
-              const relativePath = `.${url}`;
-              const absolutePath = path41.resolve(process.cwd(), relativePath);
-              if (fs41.existsSync(absolutePath)) {
-                fetchUrl = `file://${absolutePath}`;
-              } else {
-                fetchUrl = `file://${url}`;
-              }
-            }
-          }
-          return basePlatformConfig.footprintFileParserMap.kicad_mod.loadFromUrl(fetchUrl);
-        }
-      }
-    }
-  };
-  if (!userConfig) {
-    return defaultConfig;
-  }
-  return {
-    ...defaultConfig,
-    ...userConfig,
-    footprintFileParserMap: {
-      ...defaultConfig.footprintFileParserMap,
-      ...userConfig.footprintFileParserMap
-    }
-  };
+async function getLatestTscircuitCdnUrl() {
+  const version2 = await getLatestTscircuitCdnVersion();
+  return `https://cdn.jsdelivr.net/npm/tscircuit@${version2}/dist/browser.min.js`;
 }
-// cli/build/build-file.ts
-var buildFile = async (input, output, projectDir, options) => {
-  try {
-    console.log("Generating circuit JSON...");
-    const completePlatformConfig = getCompletePlatformConfig(options?.platformConfig);
-    const result = await generateCircuitJson({
-      filePath: input,
-      platformConfig: completePlatformConfig
-    });
-    fs42.mkdirSync(path42.dirname(output), { recursive: true });
-    fs42.writeFileSync(output, JSON.stringify(result.circuitJson, null, 2));
-    console.log(`Circuit JSON written to ${path42.relative(projectDir, output)}`);
-    const { errors, warnings } = analyzeCircuitJson(result.circuitJson);
-    if (!options?.ignoreWarnings) {
-      for (const warn of warnings) {
-        const msg = warn.message || JSON.stringify(warn);
-        console.log(kleur_default.yellow(msg));
-      }
-    }
-    if (!options?.ignoreErrors) {
-      for (const err of errors) {
-        const msg = err.message || JSON.stringify(err);
-        console.error(kleur_default.red(msg));
-        if (err.stack) {
-          console.log(err.stack);
-        }
-      }
-    }
-    if (errors.length > 0 && !options?.ignoreErrors) {
-      console.error(kleur_default.red(`Build failed with ${errors.length} error(s). Use --ignore-errors to continue.`));
-      return { ok: false };
-    } else {
-      return {
-        ok: true,
-        circuitJson: result.circuitJson
-      };
-    }
-  } catch (err) {
-    console.error(err);
-    if (err instanceof Error) {
-      logTsxExtensionHint(err, input);
-      logTypeReexportHint(err, input);
-    }
-    return {
-      ok: false,
-      isFatalError: {
-        errorType: "circuit_generation_failed",
-        message: err instanceof Error ? err.message : String(err)
-      }
-    };
-  }
-};
-var logTsxExtensionHint = (error, entryFilePath) => {
-  const lowerPath = entryFilePath.toLowerCase();
-  const isTsEntry = lowerPath.endsWith(".ts") && !lowerPath.endsWith(".d.ts");
-  const isAggregateError = error instanceof AggregateError || String(error).includes("AggregateError");
-  if (!isTsEntry || !isAggregateError)
+// cli/utils/validate-main-in-dist.ts
+import fs41 from "node:fs";
+import path41 from "node:path";
+var validateMainInDist = (projectDir, distDir) => {
+  const packageJsonPath = path41.join(projectDir, "package.json");
+  if (!fs41.existsSync(packageJsonPath))
     return;
-  const entryFileName = path42.basename(entryFilePath);
-  console.error([
-    "",
-    `It looks like "${entryFileName}" is a ".ts" file. tscircuit component files must use the ".tsx" extension.`,
-    "Try renaming the file to .tsx and re-running the build.",
-    ""
-  ].join(`
-`));
-};
-var TYPE_REEXPORT_ERROR_REGEX = /SyntaxError: export '([^']+)' not found in '([^']+)'/;
-var logTypeReexportHint = (error, entryFilePath) => {
-  const match = String(error).match(TYPE_REEXPORT_ERROR_REGEX);
-  if (!match)
+  const packageJson = JSON.parse(fs41.readFileSync(packageJsonPath, "utf-8"));
+  if (typeof packageJson.main !== "string")
     return;
-  const [, exportName, fromSpecifier] = match;
-  const entryFileName = path42.basename(entryFilePath);
-  console.error([
-    "",
-    `It looks like "${entryFileName}" re-exports the type-only symbol "${exportName}" from "${fromSpecifier}" without the "type" modifier.`,
-    "Type-only exports must be re-exported with `export type { ... }`.",
-    "Try rewriting the statement as:",
-    `  export type { ${exportName} } from "${fromSpecifier}"`,
-    ""
-  ].join(`
-`));
+  const resolvedMainPath = path41.resolve(projectDir, packageJson.main);
+  const isMainInDist = resolvedMainPath === distDir || resolvedMainPath.startsWith(`${distDir}${path41.sep}`);
+  if (!isMainInDist) {
+    console.warn('When using transpilation, your package\'s "main" field should point inside the `dist/*` directory, usually to "dist/index.js"');
+  }
 };
 // cli/build/build-ci.ts
 import { execSync as execSync3 } from "node:child_process";
 // lib/shared/install-project-dependencies.ts
-import fs44 from "node:fs";
-import path44 from "node:path";
-// lib/shared/collect-tsci-dependencies.ts
 import fs43 from "node:fs";
 import path43 from "node:path";
+// lib/shared/collect-tsci-dependencies.ts
+import fs42 from "node:fs";
+import path42 from "node:path";
 var DEFAULT_PATTERNS = ["**/*.{ts,tsx,js,jsx}"];
 var DEFAULT_IGNORES = [
   "**/node_modules/**",
@@ -174680,7 +174567,7 @@ function collectTsciDependencies({
   patterns = DEFAULT_PATTERNS,
   ignore = DEFAULT_IGNORES
 } = {}) {
-  const searchRoot = path43.resolve(cwd);
+  const searchRoot = path42.resolve(cwd);
   const files = globbySync(patterns, {
     cwd: searchRoot,
     absolute: true,
@@ -174690,7 +174577,7 @@ function collectTsciDependencies({
   const dependencies2 = new Set;
   for (const filePath of files) {
     try {
-      const fileContents = fs43.readFileSync(filePath, "utf-8");
+      const fileContents = fs42.readFileSync(filePath, "utf-8");
       let match;
       while (true) {
         match = IMPORT_PATTERN.exec(fileContents);
@@ -174714,31 +174601,31 @@ async function installProjectDependencies({
   cwd = process.cwd(),
   skipTscircuitPackage = false
 } = {}) {
-  const projectRoot = path44.resolve(cwd);
-  const packageJsonPath = path44.join(projectRoot, "package.json");
-  const npmrcPath = path44.join(projectRoot, ".npmrc");
+  const projectRoot = path43.resolve(cwd);
+  const packageJsonPath = path43.join(projectRoot, "package.json");
+  const npmrcPath = path43.join(projectRoot, ".npmrc");
   const packageManager = getPackageManager();
-  if (!fs44.existsSync(projectRoot)) {
+  if (!fs43.existsSync(projectRoot)) {
     throw new Error(`Directory not found: ${projectRoot}`);
   }
   let packageJsonCreated = false;
-  if (!fs44.existsSync(packageJsonPath)) {
+  if (!fs43.existsSync(packageJsonPath)) {
     console.log("No package.json found. Generating a new one.");
     generatePackageJson(projectRoot);
     packageJsonCreated = true;
   } else {
     console.log("Found existing package.json.");
   }
-  const tsconfigPath = path44.join(projectRoot, "tsconfig.json");
-  if (!fs44.existsSync(tsconfigPath)) {
+  const tsconfigPath = path43.join(projectRoot, "tsconfig.json");
+  if (!fs43.existsSync(tsconfigPath)) {
     console.log("No tsconfig.json found. Generating a new one.");
     generateTsConfig(projectRoot);
   }
-  if (!fs44.existsSync(npmrcPath)) {
+  if (!fs43.existsSync(npmrcPath)) {
     console.log("Creating .npmrc with tscircuit registry configuration.");
-    fs44.writeFileSync(npmrcPath, "@tsci:registry=https://npm.tscircuit.com");
+    fs43.writeFileSync(npmrcPath, "@tsci:registry=https://npm.tscircuit.com");
   }
-  const packageJson = JSON.parse(fs44.readFileSync(packageJsonPath, "utf-8"));
+  const packageJson = JSON.parse(fs43.readFileSync(packageJsonPath, "utf-8"));
   if (skipTscircuitPackage) {
     packageJson.dependencies = removeTscircuitPackage(packageJson.dependencies);
     console.log("Skipping tscircuit package installation from dependencies (using cloud container version).");
@@ -174757,7 +174644,7 @@ async function installProjectDependencies({
       console.log("No @tsci dependencies detected in circuit files.");
     }
   }
-  fs44.writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
+  fs43.writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
 `);
   console.log(`Installing dependencies using ${kleur_default.bold(packageManager.name)}...`);
   try {
@@ -174819,213 +174706,193 @@ var applyCiBuildOptions = async ({
   };
 };
-// cli/build/resolve-build-options.ts
-var resolveBuildOptions = ({
-  cliOptions,
-  projectConfig: projectConfig2
-}) => {
-  if (cliOptions?.ignoreConfig) {
-    return { options: cliOptions, configAppliedOpts: [] };
-  }
-  const configBuild = projectConfig2?.build;
-  const configAppliedOpts = [];
-  if (!cliOptions?.kicadProject && configBuild?.kicadProject) {
-    configAppliedOpts.push("kicad-project");
-  }
-  if (!cliOptions?.kicadLibrary && configBuild?.kicadLibrary) {
-    configAppliedOpts.push("kicad-library");
-  }
-  if (!cliOptions?.kicadPcm && configBuild?.kicadPcm) {
-    configAppliedOpts.push("kicad-pcm");
-  }
-  if (!cliOptions?.previewImages && configBuild?.previewImages) {
-    configAppliedOpts.push("preview-images");
-  }
-  if (!cliOptions?.glbs && configBuild?.glbs) {
-    configAppliedOpts.push("glbs");
-  }
-  if (!cliOptions?.transpile && configBuild?.typescriptLibrary) {
-    configAppliedOpts.push("transpile");
-  }
-  const options = {
-    ...cliOptions,
-    kicadProject: cliOptions?.kicadProject ?? configBuild?.kicadProject,
-    kicadLibrary: cliOptions?.kicadLibrary ?? configBuild?.kicadLibrary,
-    kicadLibraryName: cliOptions?.kicadLibraryName ?? projectConfig2?.kicadLibraryName,
-    kicadPcm: cliOptions?.kicadPcm ?? configBuild?.kicadPcm,
-    previewImages: cliOptions?.previewImages ?? configBuild?.previewImages,
-    glbs: cliOptions?.glbs ?? configBuild?.glbs,
-    transpile: cliOptions?.transpile ?? configBuild?.typescriptLibrary
-  };
-  return { options, configAppliedOpts };
-};
-// cli/build/get-build-entrypoints.ts
-import fs45 from "node:fs";
+// cli/build/build-file.ts
 import path45 from "node:path";
-var isSubPath2 = (maybeChild, maybeParent) => {
-  const relative10 = path45.relative(maybeParent, maybeChild);
-  return relative10 === "" || !relative10.startsWith("..") && !path45.isAbsolute(relative10);
-};
-var findProjectRoot = (startDir) => {
-  let currentDir = startDir;
-  while (currentDir !== path45.dirname(currentDir)) {
-    const packageJsonPath = path45.join(currentDir, "package.json");
-    if (fs45.existsSync(packageJsonPath)) {
-      return currentDir;
+import fs45 from "node:fs";
+// lib/shared/circuit-json-diagnostics.ts
+function analyzeCircuitJson(circuitJson) {
+  const errors = [];
+  const warnings = [];
+  for (const item of circuitJson) {
+    if (!item || typeof item !== "object")
+      continue;
+    const t3 = item.type;
+    if (typeof t3 === "string") {
+      if (t3.endsWith("_error"))
+        errors.push(item);
+      else if (t3.endsWith("_warning"))
+        warnings.push(item);
     }
-    currentDir = path45.dirname(currentDir);
+    if ("error_type" in item)
+      errors.push(item);
+    if ("warning_type" in item)
+      warnings.push(item);
   }
-  return startDir;
-};
-async function getBuildEntrypoints({
-  fileOrDir,
-  rootDir = process.cwd(),
-  includeBoardFiles = true
-}) {
-  const resolvedRoot = path45.resolve(rootDir);
-  const includeBoardFilePatterns = includeBoardFiles ? getBoardFilePatterns(resolvedRoot) : [];
-  const buildFromProjectDir = async () => {
-    const projectConfig2 = loadProjectConfig(resolvedRoot);
-    const resolvedPreviewComponentPath = projectConfig2?.previewComponentPath ? path45.resolve(resolvedRoot, projectConfig2.previewComponentPath) : undefined;
-    const resolvedSiteDefaultComponentPath = projectConfig2?.siteDefaultComponentPath ? path45.resolve(resolvedRoot, projectConfig2.siteDefaultComponentPath) : undefined;
-    if (includeBoardFiles) {
-      const files = findBoardFiles({ projectDir: resolvedRoot });
-      if (files.length > 0) {
-        return {
-          projectDir: resolvedRoot,
-          previewComponentPath: resolvedPreviewComponentPath,
-          siteDefaultComponentPath: resolvedSiteDefaultComponentPath,
-          circuitFiles: files
-        };
+  return { errors, warnings };
+}
+// lib/shared/get-complete-platform-config.ts
+import { getPlatformConfig } from "@tscircuit/eval/platform-config";
+import { createHash } from "node:crypto";
+import path44 from "node:path";
+import fs44 from "node:fs";
+function createLocalCacheEngine(cacheDir = path44.join(process.cwd(), ".tscircuit", "cache")) {
+  return {
+    getItem: (key) => {
+      try {
+        const hash = createHash("md5").update(key).digest("hex");
+        const keyWithSafeCharacters = key.replace(/[^a-zA-Z0-9]/g, "_");
+        const filePath = path44.join(cacheDir, `${keyWithSafeCharacters.slice(keyWithSafeCharacters.length - 10, keyWithSafeCharacters.length)}-${hash}.json`);
+        return fs44.readFileSync(filePath, "utf-8");
+      } catch {
+        return null;
       }
+    },
+    setItem: (key, value) => {
+      try {
+        fs44.mkdirSync(cacheDir, { recursive: true });
+        const hash = createHash("md5").update(key).digest("hex");
+        const keyWithSafeCharacters = key.replace(/[^a-zA-Z0-9]/g, "_");
+        const filePath = path44.join(cacheDir, `${keyWithSafeCharacters.slice(keyWithSafeCharacters.length - 10, keyWithSafeCharacters.length)}-${hash}.json`);
+        fs44.writeFileSync(filePath, value);
+      } catch {}
     }
-    const mainEntrypoint = await getEntrypoint({
-      projectDir: resolvedRoot,
-      onSuccess: () => {
-        return;
-      },
-      onError: () => {
-        return;
+  };
+}
+function getCompletePlatformConfig(userConfig) {
+  const basePlatformConfig = getPlatformConfig();
+  const defaultConfig = {
+    ...basePlatformConfig,
+    localCacheEngine: createLocalCacheEngine(),
+    footprintFileParserMap: {
+      ...basePlatformConfig.footprintFileParserMap,
+      kicad_mod: {
+        loadFromUrl: async (url) => {
+          let fetchUrl = url;
+          if (url.startsWith("./") || url.startsWith("../")) {
+            const absolutePath = path44.resolve(process.cwd(), url);
+            fetchUrl = `file://${absolutePath}`;
+          } else if (url.startsWith("/")) {
+            if (fs44.existsSync(url)) {
+              fetchUrl = `file://${url}`;
+            } else {
+              const relativePath = `.${url}`;
+              const absolutePath = path44.resolve(process.cwd(), relativePath);
+              if (fs44.existsSync(absolutePath)) {
+                fetchUrl = `file://${absolutePath}`;
+              } else {
+                fetchUrl = `file://${url}`;
+              }
+            }
+          }
+          return basePlatformConfig.footprintFileParserMap.kicad_mod.loadFromUrl(fetchUrl);
+        }
       }
-    });
-    if (mainEntrypoint) {
-      return {
-        projectDir: resolvedRoot,
-        mainEntrypoint,
-        previewComponentPath: resolvedPreviewComponentPath,
-        siteDefaultComponentPath: resolvedSiteDefaultComponentPath,
-        circuitFiles: [mainEntrypoint]
-      };
     }
-    return {
-      projectDir: resolvedRoot,
-      previewComponentPath: resolvedPreviewComponentPath,
-      siteDefaultComponentPath: resolvedSiteDefaultComponentPath,
-      circuitFiles: []
-    };
   };
-  if (fileOrDir) {
-    const resolved = path45.resolve(resolvedRoot, fileOrDir);
-    if (fs45.existsSync(resolved) && fs45.statSync(resolved).isDirectory()) {
-      const projectConfig3 = loadProjectConfig(resolvedRoot);
-      const resolvedPreviewComponentPath2 = projectConfig3?.previewComponentPath ? path45.resolve(resolvedRoot, projectConfig3.previewComponentPath) : undefined;
-      const resolvedSiteDefaultComponentPath2 = projectConfig3?.siteDefaultComponentPath ? path45.resolve(resolvedRoot, projectConfig3.siteDefaultComponentPath) : undefined;
-      if (includeBoardFiles) {
-        const circuitFiles = findBoardFiles({
-          projectDir: resolvedRoot,
-          filePaths: [resolved]
-        }).filter((file) => isSubPath2(file, resolved));
-        if (circuitFiles.length === 0) {
-          throw new Error(`There were no files to build found matching the includeBoardFiles globs: ${JSON.stringify(includeBoardFilePatterns)}`);
-        }
-        return {
-          projectDir: resolvedRoot,
-          previewComponentPath: resolvedPreviewComponentPath2,
-          siteDefaultComponentPath: resolvedSiteDefaultComponentPath2,
-          circuitFiles
-        };
+  if (!userConfig) {
+    return defaultConfig;
+  }
+  return {
+    ...defaultConfig,
+    ...userConfig,
+    footprintFileParserMap: {
+      ...defaultConfig.footprintFileParserMap,
+      ...userConfig.footprintFileParserMap
+    }
+  };
+}
+// cli/build/build-file.ts
+var buildFile = async (input, output, projectDir, options) => {
+  try {
+    console.log("Generating circuit JSON...");
+    const completePlatformConfig = getCompletePlatformConfig(options?.platformConfig);
+    const result = await generateCircuitJson({
+      filePath: input,
+      platformConfig: completePlatformConfig
+    });
+    fs45.mkdirSync(path45.dirname(output), { recursive: true });
+    fs45.writeFileSync(output, JSON.stringify(result.circuitJson, null, 2));
+    console.log(`Circuit JSON written to ${path45.relative(projectDir, output)}`);
+    const { errors, warnings } = analyzeCircuitJson(result.circuitJson);
+    if (!options?.ignoreWarnings) {
+      for (const warn of warnings) {
+        const msg = warn.message || JSON.stringify(warn);
+        console.log(kleur_default.yellow(msg));
       }
-      const projectDir2 = findProjectRoot(resolved);
-      const mainEntrypoint = await getEntrypoint({
-        projectDir: projectDir2,
-        onSuccess: () => {
-          return;
-        },
-        onError: () => {
-          return;
+    }
+    if (!options?.ignoreErrors) {
+      for (const err of errors) {
+        const msg = err.message || JSON.stringify(err);
+        console.error(kleur_default.red(msg));
+        if (err.stack) {
+          console.log(err.stack);
         }
-      });
+      }
+    }
+    if (errors.length > 0 && !options?.ignoreErrors) {
+      console.error(kleur_default.red(`Build failed with ${errors.length} error(s). Use --ignore-errors to continue.`));
+      return { ok: false };
+    } else {
       return {
-        projectDir: projectDir2,
-        mainEntrypoint: mainEntrypoint || undefined,
-        previewComponentPath: resolvedPreviewComponentPath2,
-        siteDefaultComponentPath: resolvedSiteDefaultComponentPath2,
-        circuitFiles: mainEntrypoint ? [mainEntrypoint] : []
+        ok: true,
+        circuitJson: result.circuitJson
       };
     }
-    const fileDir = path45.dirname(resolved);
-    const projectDir = findProjectRoot(fileDir);
-    const projectConfig2 = loadProjectConfig(projectDir);
-    const resolvedPreviewComponentPath = projectConfig2?.previewComponentPath ? path45.resolve(projectDir, projectConfig2.previewComponentPath) : undefined;
-    const resolvedSiteDefaultComponentPath = projectConfig2?.siteDefaultComponentPath ? path45.resolve(projectDir, projectConfig2.siteDefaultComponentPath) : undefined;
+  } catch (err) {
+    console.error(err);
+    if (err instanceof Error) {
+      logTsxExtensionHint(err, input);
+      logTypeReexportHint(err, input);
+    }
     return {
-      projectDir,
-      previewComponentPath: resolvedPreviewComponentPath,
-      siteDefaultComponentPath: resolvedSiteDefaultComponentPath,
-      circuitFiles: [resolved]
+      ok: false,
+      isFatalError: {
+        errorType: "circuit_generation_failed",
+        message: err instanceof Error ? err.message : String(err)
+      }
     };
   }
-  return buildFromProjectDir();
-}
-// lib/site/getStaticIndexHtmlFile.ts
-var getStaticIndexHtmlFile = ({
-  files,
-  standaloneScriptSrc = "./standalone.min.js",
-  defaultMainComponentPath,
-  packageName
-}) => {
-  const scriptLines = [
-    "window.TSCIRCUIT_USE_RUNFRAME_FOR_CLI = false;",
-    `window.TSCIRCUIT_RUNFRAME_STATIC_FILE_LIST = ${JSON.stringify(files)};`,
-    ...defaultMainComponentPath ? [
-      `window.TSCIRCUIT_DEFAULT_MAIN_COMPONENT_PATH = ${JSON.stringify(defaultMainComponentPath)};`
-    ] : [],
-    ...packageName ? [`window.TSCIRCUIT_PACKAGE_NAME = ${JSON.stringify(packageName)};`] : []
-  ];
-  const scriptBlock = `      <script>
-        ${scriptLines.join(`
-        `)}
-      </script>
-`;
-  return `<html>
-    <head>
-      <link rel="icon" type="image/png" href="https://github.com/tscircuit.png">
-      <meta charset="UTF-8" />
-      <title>tscircuit</title>
-      <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    </head>
-    <body>
-${scriptBlock}      <script src="https://cdn.tailwindcss.com"></script>
-      <div id="root">loading...</div>
-      <script>
-      globalThis.process = { env: { NODE_ENV: "production" } }
-      </script>
-      <script type="module" src="${standaloneScriptSrc}"></script>
-    </body>
-  </html>`;
+};
+var logTsxExtensionHint = (error, entryFilePath) => {
+  const lowerPath = entryFilePath.toLowerCase();
+  const isTsEntry = lowerPath.endsWith(".ts") && !lowerPath.endsWith(".d.ts");
+  const isAggregateError = error instanceof AggregateError || String(error).includes("AggregateError");
+  if (!isTsEntry || !isAggregateError)
+    return;
+  const entryFileName = path45.basename(entryFilePath);
+  console.error([
+    "",
+    `It looks like "${entryFileName}" is a ".ts" file. tscircuit component files must use the ".tsx" extension.`,
+    "Try renaming the file to .tsx and re-running the build.",
+    ""
+  ].join(`
+`));
+};
+var TYPE_REEXPORT_ERROR_REGEX = /SyntaxError: export '([^']+)' not found in '([^']+)'/;
+var logTypeReexportHint = (error, entryFilePath) => {
+  const match = String(error).match(TYPE_REEXPORT_ERROR_REGEX);
+  if (!match)
+    return;
+  const [, exportName, fromSpecifier] = match;
+  const entryFileName = path45.basename(entryFilePath);
+  console.error([
+    "",
+    `It looks like "${entryFileName}" re-exports the type-only symbol "${exportName}" from "${fromSpecifier}" without the "type" modifier.`,
+    "Type-only exports must be re-exported with `export type { ... }`.",
+    "Try rewriting the statement as:",
+    `  export type { ${exportName} } from "${fromSpecifier}"`,
+    ""
+  ].join(`
+`));
 };
-// cli/build/build-preview-images.ts
+// cli/build/build-glbs.ts
 import fs46 from "node:fs";
 import path47 from "node:path";
 import { convertCircuitJsonToGltf as convertCircuitJsonToGltf2 } from "circuit-json-to-gltf";
-import {
-  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg2,
-  convertCircuitJsonToSchematicSvg as convertCircuitJsonToSchematicSvg2
-} from "circuit-to-svg";
-import { renderGLTFToPNGBufferFromGLBBuffer } from "poppygl";
 // cli/build/convert-model-urls-to-file-urls.ts
 import path46 from "node:path";
@@ -175063,18 +174930,127 @@ var convertModelUrlsToFileUrls = (circuitJson) => {
   });
 };
-// cli/build/build-preview-images.ts
+// cli/build/build-glbs.ts
 var viewToArrayBuffer = (view) => {
   const copy = new Uint8Array(view.byteLength);
   copy.set(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
   return copy.buffer;
 };
+var normalizeToUint8Array = (value) => {
+  if (value instanceof Uint8Array) {
+    return value;
+  }
+  if (value instanceof ArrayBuffer) {
+    return new Uint8Array(value);
+  }
+  if (ArrayBuffer.isView(value)) {
+    return new Uint8Array(viewToArrayBuffer(value));
+  }
+  throw new Error("Expected Uint8Array, ArrayBuffer, or ArrayBufferView for GLB");
+};
+var buildGlbs = async ({
+  builtFiles,
+  distDir
+}) => {
+  const successfulBuilds = builtFiles.filter((file) => file.ok);
+  if (successfulBuilds.length === 0) {
+    console.warn("No successful build output available for GLB generation.");
+    return;
+  }
+  for (const build of successfulBuilds) {
+    const outputDir = path47.dirname(build.outputPath);
+    const prefixRelative = path47.relative(distDir, outputDir) || ".";
+    const prefix = prefixRelative === "." ? "" : `[${prefixRelative}] `;
+    let circuitJson;
+    try {
+      const circuitJsonRaw = fs46.readFileSync(build.outputPath, "utf-8");
+      circuitJson = JSON.parse(circuitJsonRaw);
+    } catch (error) {
+      console.error(`${prefix}Failed to read circuit JSON:`, error);
+      continue;
+    }
+    try {
+      console.log(`${prefix}Converting circuit to GLB...`);
+      const circuitJsonWithFileUrls = convertModelUrlsToFileUrls(circuitJson);
+      const glbBuffer = await convertCircuitJsonToGltf2(circuitJsonWithFileUrls, getCircuitJsonToGltfOptions({ format: "glb" }));
+      const glbData = normalizeToUint8Array(glbBuffer);
+      fs46.writeFileSync(path47.join(outputDir, "3d.glb"), Buffer.from(glbData));
+      console.log(`${prefix}Written 3d.glb`);
+    } catch (error) {
+      console.error(`${prefix}Failed to generate GLB:`, error);
+    }
+  }
+};
+// cli/build/build-preview-gltf.ts
+import fs47 from "node:fs";
+import path48 from "node:path";
+import { convertCircuitJsonToGltf as convertCircuitJsonToGltf3 } from "circuit-json-to-gltf";
+var buildPreviewGltf = async ({
+  builtFiles,
+  distDir,
+  mainEntrypoint,
+  previewComponentPath
+}) => {
+  const successfulBuilds = builtFiles.filter((file) => file.ok);
+  const previewEntrypoint = previewComponentPath || mainEntrypoint;
+  const resolvedPreviewEntrypoint = previewEntrypoint ? path48.resolve(previewEntrypoint) : undefined;
+  const previewBuild = (() => {
+    if (resolvedPreviewEntrypoint) {
+      const match = successfulBuilds.find((built) => path48.resolve(built.sourcePath) === resolvedPreviewEntrypoint);
+      if (match)
+        return match;
+    }
+    return successfulBuilds[0];
+  })();
+  if (!previewBuild) {
+    console.warn("No successful build output available for preview GLTF generation.");
+    return;
+  }
+  let circuitJson;
+  try {
+    const circuitJsonRaw = fs47.readFileSync(previewBuild.outputPath, "utf-8");
+    circuitJson = JSON.parse(circuitJsonRaw);
+  } catch (error) {
+    console.error("Failed to read circuit JSON:", error);
+    return;
+  }
+  const sourcePath = previewBuild.sourcePath;
+  const sourceBasename = path48.basename(sourcePath);
+  const gltfFilename = sourceBasename.replace(/(\.(board|circuit))?\.tsx?$/, ".gltf");
+  const outputPath = path48.join(distDir, gltfFilename);
+  try {
+    console.log("Converting circuit to GLTF...");
+    const circuitJsonWithFileUrls = convertModelUrlsToFileUrls(circuitJson);
+    const gltfData = await convertCircuitJsonToGltf3(circuitJsonWithFileUrls, getCircuitJsonToGltfOptions({ format: "gltf" }));
+    const gltfContent = JSON.stringify(gltfData, null, 2);
+    fs47.writeFileSync(outputPath, gltfContent, "utf-8");
+    console.log(`Written ${gltfFilename}`);
+  } catch (error) {
+    console.error("Failed to generate GLTF:", error);
+  }
+};
+// cli/build/build-preview-images.ts
+import fs48 from "node:fs";
+import path49 from "node:path";
+import { convertCircuitJsonToGltf as convertCircuitJsonToGltf4 } from "circuit-json-to-gltf";
+import {
+  convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg2,
+  convertCircuitJsonToSchematicSvg as convertCircuitJsonToSchematicSvg2
+} from "circuit-to-svg";
+import { renderGLTFToPNGBufferFromGLBBuffer } from "poppygl";
+var viewToArrayBuffer2 = (view) => {
+  const copy = new Uint8Array(view.byteLength);
+  copy.set(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
+  return copy.buffer;
+};
 var normalizeToArrayBuffer = async (value) => {
   if (value instanceof ArrayBuffer) {
     return value;
   }
   if (ArrayBuffer.isView(value)) {
-    return viewToArrayBuffer(value);
+    return viewToArrayBuffer2(value);
   }
   if (value && typeof value === "object") {
     const maybeArrayBufferLike = value;
@@ -175085,7 +175061,7 @@ var normalizeToArrayBuffer = async (value) => {
   }
   throw new Error("Expected ArrayBuffer, ArrayBufferView, or Buffer-compatible object");
 };
-var normalizeToUint8Array = (value) => {
+var normalizeToUint8Array2 = (value) => {
   if (value instanceof Uint8Array) {
     return value;
   }
@@ -175093,7 +175069,7 @@ var normalizeToUint8Array = (value) => {
     return new Uint8Array(value);
   }
   if (ArrayBuffer.isView(value)) {
-    return new Uint8Array(viewToArrayBuffer(value));
+    return new Uint8Array(viewToArrayBuffer2(value));
   }
   throw new Error("Expected Uint8Array, ArrayBuffer, or ArrayBufferView for PNG");
 };
@@ -175102,21 +175078,21 @@ var generatePreviewAssets = async ({
   outputDir,
   distDir
 }) => {
-  const prefixRelative = path47.relative(distDir, outputDir) || ".";
+  const prefixRelative = path49.relative(distDir, outputDir) || ".";
   const prefix = prefixRelative === "." ? "" : `[${prefixRelative}] `;
   let circuitJson;
   try {
-    const circuitJsonRaw = fs46.readFileSync(build.outputPath, "utf-8");
+    const circuitJsonRaw = fs48.readFileSync(build.outputPath, "utf-8");
     circuitJson = JSON.parse(circuitJsonRaw);
   } catch (error) {
     console.error(`${prefix}Failed to read circuit JSON:`, error);
     return;
   }
-  fs46.mkdirSync(outputDir, { recursive: true });
+  fs48.mkdirSync(outputDir, { recursive: true });
   try {
     console.log(`${prefix}Generating PCB SVG...`);
     const pcbSvg = convertCircuitJsonToPcbSvg2(circuitJson);
-    fs46.writeFileSync(path47.join(outputDir, "pcb.svg"), pcbSvg, "utf-8");
+    fs48.writeFileSync(path49.join(outputDir, "pcb.svg"), pcbSvg, "utf-8");
     console.log(`${prefix}Written pcb.svg`);
   } catch (error) {
     console.error(`${prefix}Failed to generate PCB SVG:`, error);
@@ -175124,7 +175100,7 @@ var generatePreviewAssets = async ({
   try {
     console.log(`${prefix}Generating schematic SVG...`);
     const schematicSvg = convertCircuitJsonToSchematicSvg2(circuitJson);
-    fs46.writeFileSync(path47.join(outputDir, "schematic.svg"), schematicSvg, "utf-8");
+    fs48.writeFileSync(path49.join(outputDir, "schematic.svg"), schematicSvg, "utf-8");
     console.log(`${prefix}Written schematic.svg`);
   } catch (error) {
     console.error(`${prefix}Failed to generate schematic SVG:`, error);
@@ -175132,14 +175108,14 @@ var generatePreviewAssets = async ({
   try {
     console.log(`${prefix}Converting circuit to GLB...`);
     const circuitJsonWithFileUrls = convertModelUrlsToFileUrls(circuitJson);
-    const glbBuffer = await convertCircuitJsonToGltf2(circuitJsonWithFileUrls, getCircuitJsonToGltfOptions({ format: "glb" }));
+    const glbBuffer = await convertCircuitJsonToGltf4(circuitJsonWithFileUrls, getCircuitJsonToGltfOptions({ format: "glb" }));
     console.log(`${prefix}Rendering GLB to PNG buffer...`);
     const glbArrayBuffer = await normalizeToArrayBuffer(glbBuffer);
     const pngBuffer = await renderGLTFToPNGBufferFromGLBBuffer(glbArrayBuffer, {
       camPos: [10, 10, 10],
       lookAt: [0, 0, 0]
     });
-    fs46.writeFileSync(path47.join(outputDir, "3d.png"), Buffer.from(normalizeToUint8Array(pngBuffer)));
+    fs48.writeFileSync(path49.join(outputDir, "3d.png"), Buffer.from(normalizeToUint8Array2(pngBuffer)));
     console.log(`${prefix}Written 3d.png`);
   } catch (error) {
     console.error(`${prefix}Failed to generate 3D PNG:`, error);
@@ -175154,14 +175130,14 @@ var buildPreviewImages = async ({
 }) => {
   const successfulBuilds = builtFiles.filter((file) => file.ok);
   const previewEntrypoint = previewComponentPath || mainEntrypoint;
-  const resolvedPreviewEntrypoint = previewEntrypoint ? path47.resolve(previewEntrypoint) : undefined;
+  const resolvedPreviewEntrypoint = previewEntrypoint ? path49.resolve(previewEntrypoint) : undefined;
   if (allImages) {
     if (successfulBuilds.length === 0) {
       console.warn("No successful build output available for preview image generation.");
       return;
     }
     for (const build of successfulBuilds) {
-      const outputDir = path47.dirname(build.outputPath);
+      const outputDir = path49.dirname(build.outputPath);
       await generatePreviewAssets({
         build,
         outputDir,
@@ -175172,7 +175148,7 @@ var buildPreviewImages = async ({
   }
   const previewBuild = (() => {
     if (resolvedPreviewEntrypoint) {
-      const match = successfulBuilds.find((built) => path47.resolve(built.sourcePath) === resolvedPreviewEntrypoint);
+      const match = successfulBuilds.find((built) => path49.resolve(built.sourcePath) === resolvedPreviewEntrypoint);
       if (match)
         return match;
     }
@@ -175189,110 +175165,6 @@ var buildPreviewImages = async ({
   });
 };
-// cli/build/build-preview-gltf.ts
-import fs47 from "node:fs";
-import path48 from "node:path";
-import { convertCircuitJsonToGltf as convertCircuitJsonToGltf3 } from "circuit-json-to-gltf";
-var buildPreviewGltf = async ({
-  builtFiles,
-  distDir,
-  mainEntrypoint,
-  previewComponentPath
-}) => {
-  const successfulBuilds = builtFiles.filter((file) => file.ok);
-  const previewEntrypoint = previewComponentPath || mainEntrypoint;
-  const resolvedPreviewEntrypoint = previewEntrypoint ? path48.resolve(previewEntrypoint) : undefined;
-  const previewBuild = (() => {
-    if (resolvedPreviewEntrypoint) {
-      const match = successfulBuilds.find((built) => path48.resolve(built.sourcePath) === resolvedPreviewEntrypoint);
-      if (match)
-        return match;
-    }
-    return successfulBuilds[0];
-  })();
-  if (!previewBuild) {
-    console.warn("No successful build output available for preview GLTF generation.");
-    return;
-  }
-  let circuitJson;
-  try {
-    const circuitJsonRaw = fs47.readFileSync(previewBuild.outputPath, "utf-8");
-    circuitJson = JSON.parse(circuitJsonRaw);
-  } catch (error) {
-    console.error("Failed to read circuit JSON:", error);
-    return;
-  }
-  const sourcePath = previewBuild.sourcePath;
-  const sourceBasename = path48.basename(sourcePath);
-  const gltfFilename = sourceBasename.replace(/(\.(board|circuit))?\.tsx?$/, ".gltf");
-  const outputPath = path48.join(distDir, gltfFilename);
-  try {
-    console.log("Converting circuit to GLTF...");
-    const circuitJsonWithFileUrls = convertModelUrlsToFileUrls(circuitJson);
-    const gltfData = await convertCircuitJsonToGltf3(circuitJsonWithFileUrls, getCircuitJsonToGltfOptions({ format: "gltf" }));
-    const gltfContent = JSON.stringify(gltfData, null, 2);
-    fs47.writeFileSync(outputPath, gltfContent, "utf-8");
-    console.log(`Written ${gltfFilename}`);
-  } catch (error) {
-    console.error("Failed to generate GLTF:", error);
-  }
-};
-// cli/build/build-glbs.ts
-import fs48 from "node:fs";
-import path49 from "node:path";
-import { convertCircuitJsonToGltf as convertCircuitJsonToGltf4 } from "circuit-json-to-gltf";
-var viewToArrayBuffer2 = (view) => {
-  const copy = new Uint8Array(view.byteLength);
-  copy.set(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
-  return copy.buffer;
-};
-var normalizeToUint8Array2 = (value) => {
-  if (value instanceof Uint8Array) {
-    return value;
-  }
-  if (value instanceof ArrayBuffer) {
-    return new Uint8Array(value);
-  }
-  if (ArrayBuffer.isView(value)) {
-    return new Uint8Array(viewToArrayBuffer2(value));
-  }
-  throw new Error("Expected Uint8Array, ArrayBuffer, or ArrayBufferView for GLB");
-};
-var buildGlbs = async ({
-  builtFiles,
-  distDir
-}) => {
-  const successfulBuilds = builtFiles.filter((file) => file.ok);
-  if (successfulBuilds.length === 0) {
-    console.warn("No successful build output available for GLB generation.");
-    return;
-  }
-  for (const build of successfulBuilds) {
-    const outputDir = path49.dirname(build.outputPath);
-    const prefixRelative = path49.relative(distDir, outputDir) || ".";
-    const prefix = prefixRelative === "." ? "" : `[${prefixRelative}] `;
-    let circuitJson;
-    try {
-      const circuitJsonRaw = fs48.readFileSync(build.outputPath, "utf-8");
-      circuitJson = JSON.parse(circuitJsonRaw);
-    } catch (error) {
-      console.error(`${prefix}Failed to read circuit JSON:`, error);
-      continue;
-    }
-    try {
-      console.log(`${prefix}Converting circuit to GLB...`);
-      const circuitJsonWithFileUrls = convertModelUrlsToFileUrls(circuitJson);
-      const glbBuffer = await convertCircuitJsonToGltf4(circuitJsonWithFileUrls, getCircuitJsonToGltfOptions({ format: "glb" }));
-      const glbData = normalizeToUint8Array2(glbBuffer);
-      fs48.writeFileSync(path49.join(outputDir, "3d.glb"), Buffer.from(glbData));
-      console.log(`${prefix}Written 3d.glb`);
-    } catch (error) {
-      console.error(`${prefix}Failed to generate GLB:`, error);
-    }
-  }
-};
 // cli/build/generate-kicad-project.ts
 import fs49 from "node:fs";
 import path50 from "node:path";
@@ -175349,9 +175221,169 @@ var generateKicadProject = async ({
   };
 };
+// cli/build/get-build-entrypoints.ts
+import fs50 from "node:fs";
+import path51 from "node:path";
+var isSubPath2 = (maybeChild, maybeParent) => {
+  const relative10 = path51.relative(maybeParent, maybeChild);
+  return relative10 === "" || !relative10.startsWith("..") && !path51.isAbsolute(relative10);
+};
+var findProjectRoot = (startDir) => {
+  let currentDir = startDir;
+  while (currentDir !== path51.dirname(currentDir)) {
+    const packageJsonPath = path51.join(currentDir, "package.json");
+    if (fs50.existsSync(packageJsonPath)) {
+      return currentDir;
+    }
+    currentDir = path51.dirname(currentDir);
+  }
+  return startDir;
+};
+async function getBuildEntrypoints({
+  fileOrDir,
+  rootDir = process.cwd(),
+  includeBoardFiles = true
+}) {
+  const resolvedRoot = path51.resolve(rootDir);
+  const includeBoardFilePatterns = includeBoardFiles ? getBoardFilePatterns(resolvedRoot) : [];
+  const buildFromProjectDir = async () => {
+    const projectConfig2 = loadProjectConfig(resolvedRoot);
+    const resolvedPreviewComponentPath = projectConfig2?.previewComponentPath ? path51.resolve(resolvedRoot, projectConfig2.previewComponentPath) : undefined;
+    const resolvedSiteDefaultComponentPath = projectConfig2?.siteDefaultComponentPath ? path51.resolve(resolvedRoot, projectConfig2.siteDefaultComponentPath) : undefined;
+    if (includeBoardFiles) {
+      const files = findBoardFiles({ projectDir: resolvedRoot });
+      if (files.length > 0) {
+        return {
+          projectDir: resolvedRoot,
+          previewComponentPath: resolvedPreviewComponentPath,
+          siteDefaultComponentPath: resolvedSiteDefaultComponentPath,
+          circuitFiles: files
+        };
+      }
+    }
+    const mainEntrypoint = await getEntrypoint({
+      projectDir: resolvedRoot,
+      onSuccess: () => {
+        return;
+      },
+      onError: () => {
+        return;
+      }
+    });
+    if (mainEntrypoint) {
+      return {
+        projectDir: resolvedRoot,
+        mainEntrypoint,
+        previewComponentPath: resolvedPreviewComponentPath,
+        siteDefaultComponentPath: resolvedSiteDefaultComponentPath,
+        circuitFiles: [mainEntrypoint]
+      };
+    }
+    return {
+      projectDir: resolvedRoot,
+      previewComponentPath: resolvedPreviewComponentPath,
+      siteDefaultComponentPath: resolvedSiteDefaultComponentPath,
+      circuitFiles: []
+    };
+  };
+  if (fileOrDir) {
+    const resolved = path51.resolve(resolvedRoot, fileOrDir);
+    if (fs50.existsSync(resolved) && fs50.statSync(resolved).isDirectory()) {
+      const projectConfig3 = loadProjectConfig(resolvedRoot);
+      const resolvedPreviewComponentPath2 = projectConfig3?.previewComponentPath ? path51.resolve(resolvedRoot, projectConfig3.previewComponentPath) : undefined;
+      const resolvedSiteDefaultComponentPath2 = projectConfig3?.siteDefaultComponentPath ? path51.resolve(resolvedRoot, projectConfig3.siteDefaultComponentPath) : undefined;
+      if (includeBoardFiles) {
+        const circuitFiles = findBoardFiles({
+          projectDir: resolvedRoot,
+          filePaths: [resolved]
+        }).filter((file) => isSubPath2(file, resolved));
+        if (circuitFiles.length === 0) {
+          throw new Error(`There were no files to build found matching the includeBoardFiles globs: ${JSON.stringify(includeBoardFilePatterns)}`);
+        }
+        return {
+          projectDir: resolvedRoot,
+          previewComponentPath: resolvedPreviewComponentPath2,
+          siteDefaultComponentPath: resolvedSiteDefaultComponentPath2,
+          circuitFiles
+        };
+      }
+      const projectDir2 = findProjectRoot(resolved);
+      const mainEntrypoint = await getEntrypoint({
+        projectDir: projectDir2,
+        onSuccess: () => {
+          return;
+        },
+        onError: () => {
+          return;
+        }
+      });
+      return {
+        projectDir: projectDir2,
+        mainEntrypoint: mainEntrypoint || undefined,
+        previewComponentPath: resolvedPreviewComponentPath2,
+        siteDefaultComponentPath: resolvedSiteDefaultComponentPath2,
+        circuitFiles: mainEntrypoint ? [mainEntrypoint] : []
+      };
+    }
+    const fileDir = path51.dirname(resolved);
+    const projectDir = findProjectRoot(fileDir);
+    const projectConfig2 = loadProjectConfig(projectDir);
+    const resolvedPreviewComponentPath = projectConfig2?.previewComponentPath ? path51.resolve(projectDir, projectConfig2.previewComponentPath) : undefined;
+    const resolvedSiteDefaultComponentPath = projectConfig2?.siteDefaultComponentPath ? path51.resolve(projectDir, projectConfig2.siteDefaultComponentPath) : undefined;
+    return {
+      projectDir,
+      previewComponentPath: resolvedPreviewComponentPath,
+      siteDefaultComponentPath: resolvedSiteDefaultComponentPath,
+      circuitFiles: [resolved]
+    };
+  }
+  return buildFromProjectDir();
+}
+// cli/build/resolve-build-options.ts
+var resolveBuildOptions = ({
+  cliOptions,
+  projectConfig: projectConfig2
+}) => {
+  if (cliOptions?.ignoreConfig) {
+    return { options: cliOptions, configAppliedOpts: [] };
+  }
+  const configBuild = projectConfig2?.build;
+  const configAppliedOpts = [];
+  if (!cliOptions?.kicadProject && configBuild?.kicadProject) {
+    configAppliedOpts.push("kicad-project");
+  }
+  if (!cliOptions?.kicadLibrary && configBuild?.kicadLibrary) {
+    configAppliedOpts.push("kicad-library");
+  }
+  if (!cliOptions?.kicadPcm && configBuild?.kicadPcm) {
+    configAppliedOpts.push("kicad-pcm");
+  }
+  if (!cliOptions?.previewImages && configBuild?.previewImages) {
+    configAppliedOpts.push("preview-images");
+  }
+  if (!cliOptions?.glbs && configBuild?.glbs) {
+    configAppliedOpts.push("glbs");
+  }
+  if (!cliOptions?.transpile && configBuild?.typescriptLibrary) {
+    configAppliedOpts.push("transpile");
+  }
+  const options = {
+    ...cliOptions,
+    kicadProject: cliOptions?.kicadProject ?? configBuild?.kicadProject,
+    kicadLibrary: cliOptions?.kicadLibrary ?? configBuild?.kicadLibrary,
+    kicadLibraryName: cliOptions?.kicadLibraryName ?? projectConfig2?.kicadLibraryName,
+    kicadPcm: cliOptions?.kicadPcm ?? configBuild?.kicadPcm,
+    previewImages: cliOptions?.previewImages ?? configBuild?.previewImages,
+    glbs: cliOptions?.glbs ?? configBuild?.glbs,
+    transpile: cliOptions?.transpile ?? configBuild?.typescriptLibrary
+  };
+  return { options, configAppliedOpts };
+};
 // cli/build/transpile/index.ts
-import path52 from "node:path";
-import fs51 from "node:fs";
+import path53 from "node:path";
+import fs52 from "node:fs";
 import { rollup } from "rollup";
 import typescript from "@rollup/plugin-typescript";
 import resolve11 from "@rollup/plugin-node-resolve";
@@ -175360,11 +175392,11 @@ import json from "@rollup/plugin-json";
 import dts from "rollup-plugin-dts";
 // cli/build/transpile/static-asset-plugin.ts
-import fs50 from "node:fs";
-import path51 from "node:path";
+import fs51 from "node:fs";
+import path52 from "node:path";
 import { createHash as createHash2 } from "node:crypto";
 function normalizePathSeparators(filePath) {
-  return filePath.split(path51.sep).join("/");
+  return filePath.split(path52.sep).join("/");
 }
 var STATIC_ASSET_EXTENSIONS = new Set([
   ".glb",
@@ -175395,24 +175427,24 @@ var createStaticAssetPlugin = ({
   return {
     name: "tsci-static-assets",
     resolveId(source, importer) {
-      const ext = path51.extname(source).toLowerCase();
+      const ext = path52.extname(source).toLowerCase();
       if (!STATIC_ASSET_EXTENSIONS.has(ext))
         return null;
-      if (path51.isAbsolute(source)) {
-        return fs50.existsSync(source) ? { id: normalizePathSeparators(source), external: true } : null;
+      if (path52.isAbsolute(source)) {
+        return fs51.existsSync(source) ? { id: normalizePathSeparators(source), external: true } : null;
       }
       if (importer) {
-        const importerNative = importer.split("/").join(path51.sep);
-        const resolvedFromImporter = path51.resolve(path51.dirname(importerNative), source);
-        if (fs50.existsSync(resolvedFromImporter)) {
+        const importerNative = importer.split("/").join(path52.sep);
+        const resolvedFromImporter = path52.resolve(path52.dirname(importerNative), source);
+        if (fs51.existsSync(resolvedFromImporter)) {
           return {
             id: normalizePathSeparators(resolvedFromImporter),
             external: true
           };
         }
       }
-      const resolvedFromProject = path51.resolve(resolvedBaseUrl, source);
-      if (fs50.existsSync(resolvedFromProject)) {
+      const resolvedFromProject = path52.resolve(resolvedBaseUrl, source);
+      if (fs51.existsSync(resolvedFromProject)) {
         return {
           id: normalizePathSeparators(resolvedFromProject),
           external: true
@@ -175425,8 +175457,8 @@ var createStaticAssetPlugin = ({
           const wildcard = isWildcard ? source.slice(patternPrefix.length) : "";
           for (const target of targets) {
             const targetPath = isWildcard ? target.replace("*", wildcard) : target;
-            const resolvedTarget = path51.resolve(resolvedBaseUrl, targetPath);
-            if (fs50.existsSync(resolvedTarget)) {
+            const resolvedTarget = path52.resolve(resolvedBaseUrl, targetPath);
+            if (fs51.existsSync(resolvedTarget)) {
               return {
                 id: normalizePathSeparators(resolvedTarget),
                 external: true
@@ -175452,18 +175484,18 @@ var createStaticAssetPlugin = ({
         if (chunk.type !== "chunk")
           continue;
         for (const importedId of chunk.imports) {
-          const ext = path51.extname(importedId).toLowerCase();
+          const ext = path52.extname(importedId).toLowerCase();
           if (!STATIC_ASSET_EXTENSIONS.has(ext))
             continue;
           if (!copiedAssets.has(importedId)) {
-            const assetDir = path51.join(outputDir, "assets");
-            fs50.mkdirSync(assetDir, { recursive: true });
-            const nativePath = importedId.split("/").join(path51.sep);
-            const fileBuffer = fs50.readFileSync(nativePath);
+            const assetDir = path52.join(outputDir, "assets");
+            fs51.mkdirSync(assetDir, { recursive: true });
+            const nativePath = importedId.split("/").join(path52.sep);
+            const fileBuffer = fs51.readFileSync(nativePath);
             const hash = createHash2("sha1").update(fileBuffer).digest("hex").slice(0, 8);
-            const fileName = `${path51.basename(importedId, ext)}-${hash}${ext}`;
-            const outputFilePath = path51.join(assetDir, fileName);
-            fs50.writeFileSync(outputFilePath, fileBuffer);
+            const fileName = `${path52.basename(importedId, ext)}-${hash}${ext}`;
+            const outputFilePath = path52.join(assetDir, fileName);
+            fs51.writeFileSync(outputFilePath, fileBuffer);
             copiedAssets.set(importedId, `./assets/${fileName}`);
             assetIdToOutputPath.set(importedId, `./assets/${fileName}`);
           }
@@ -175485,17 +175517,17 @@ function escapeRegExp(string) {
 // cli/build/transpile/index.ts
 var createExternalFunction = (projectDir, tsconfigPath) => (id) => {
-  if (id.startsWith(".") || id.startsWith("/") || path52.isAbsolute(id)) {
+  if (id.startsWith(".") || id.startsWith("/") || path53.isAbsolute(id)) {
     return false;
   }
   let baseUrl = projectDir;
   let pathMappings = {};
-  if (tsconfigPath && fs51.existsSync(tsconfigPath)) {
+  if (tsconfigPath && fs52.existsSync(tsconfigPath)) {
     try {
-      const tsconfigContent = fs51.readFileSync(tsconfigPath, "utf-8");
+      const tsconfigContent = fs52.readFileSync(tsconfigPath, "utf-8");
       const tsconfig = JSON.parse(tsconfigContent);
       if (tsconfig.compilerOptions?.baseUrl) {
-        baseUrl = path52.resolve(path52.dirname(tsconfigPath), tsconfig.compilerOptions.baseUrl);
+        baseUrl = path53.resolve(path53.dirname(tsconfigPath), tsconfig.compilerOptions.baseUrl);
       }
       if (tsconfig.compilerOptions?.paths) {
         pathMappings = tsconfig.compilerOptions.paths;
@@ -175509,17 +175541,17 @@ var createExternalFunction = (projectDir, tsconfigPath) => (id) => {
     }
   }
   const potentialPaths = [
-    path52.join(baseUrl, id),
-    path52.join(baseUrl, `${id}.ts`),
-    path52.join(baseUrl, `${id}.tsx`),
-    path52.join(baseUrl, `${id}.js`),
-    path52.join(baseUrl, `${id}.jsx`),
-    path52.join(baseUrl, id, "index.ts"),
-    path52.join(baseUrl, id, "index.tsx"),
-    path52.join(baseUrl, id, "index.js"),
-    path52.join(baseUrl, id, "index.jsx")
+    path53.join(baseUrl, id),
+    path53.join(baseUrl, `${id}.ts`),
+    path53.join(baseUrl, `${id}.tsx`),
+    path53.join(baseUrl, `${id}.js`),
+    path53.join(baseUrl, `${id}.jsx`),
+    path53.join(baseUrl, id, "index.ts"),
+    path53.join(baseUrl, id, "index.tsx"),
+    path53.join(baseUrl, id, "index.js"),
+    path53.join(baseUrl, id, "index.jsx")
   ];
-  if (potentialPaths.some((p4) => fs51.existsSync(p4))) {
+  if (potentialPaths.some((p4) => fs52.existsSync(p4))) {
     return false;
   }
   return true;
@@ -175530,17 +175562,17 @@ var transpileFile = async ({
   projectDir
 }) => {
   try {
-    fs51.mkdirSync(outputDir, { recursive: true });
-    const tsconfigPath = path52.join(projectDir, "tsconfig.json");
-    const hasTsConfig = fs51.existsSync(tsconfigPath);
+    fs52.mkdirSync(outputDir, { recursive: true });
+    const tsconfigPath = path53.join(projectDir, "tsconfig.json");
+    const hasTsConfig = fs52.existsSync(tsconfigPath);
     let tsconfigBaseUrl = projectDir;
     let tsconfigPathMappings;
     if (hasTsConfig) {
       try {
-        const tsconfigContent = fs51.readFileSync(tsconfigPath, "utf-8");
+        const tsconfigContent = fs52.readFileSync(tsconfigPath, "utf-8");
         const tsconfig = JSON.parse(tsconfigContent);
         if (tsconfig.compilerOptions?.baseUrl) {
-          tsconfigBaseUrl = path52.resolve(path52.dirname(tsconfigPath), tsconfig.compilerOptions.baseUrl);
+          tsconfigBaseUrl = path53.resolve(path53.dirname(tsconfigPath), tsconfig.compilerOptions.baseUrl);
         }
         if (tsconfig.compilerOptions?.paths) {
           tsconfigPathMappings = tsconfig.compilerOptions.paths;
@@ -175595,27 +175627,27 @@ var transpileFile = async ({
       external: createExternalFunction(projectDir, hasTsConfig ? tsconfigPath : undefined),
       plugins: getPlugins()
     });
-    const esmOutputPath = path52.join(outputDir, "index.js");
+    const esmOutputPath = path53.join(outputDir, "index.js");
     await esmBundle.write({
       file: esmOutputPath,
       format: "es",
       sourcemap: false
     });
-    console.log(`ESM bundle written to ${path52.relative(projectDir, esmOutputPath)}`);
+    console.log(`ESM bundle written to ${path53.relative(projectDir, esmOutputPath)}`);
     console.log("Building CommonJS bundle...");
     const cjsBundle = await rollup({
       input,
       external: createExternalFunction(projectDir, hasTsConfig ? tsconfigPath : undefined),
       plugins: getPlugins()
     });
-    const cjsOutputPath = path52.join(outputDir, "index.cjs");
+    const cjsOutputPath = path53.join(outputDir, "index.cjs");
     console.log("Writing CJS bundle to:", cjsOutputPath);
     await cjsBundle.write({
       file: cjsOutputPath,
       format: "cjs",
       sourcemap: false
     });
-    console.log(`CommonJS bundle written to ${path52.relative(projectDir, cjsOutputPath)}`);
+    console.log(`CommonJS bundle written to ${path53.relative(projectDir, cjsOutputPath)}`);
     console.log("Generating type declarations...");
     const dtsBundle = await rollup({
       input,
@@ -175640,9 +175672,9 @@ var transpileFile = async ({
     dtsContent = dtsContent.replace(/import \* as [\w_]+ from ['"]react\/jsx-runtime['"];?\s*\n?/g, "");
     dtsContent = dtsContent.replace(/[\w_]+\.JSX\.Element/g, "any");
     dtsContent = dtsContent.replace(/export\s*{\s*};\s*$/gm, "").trim();
-    const dtsOutputPath = path52.join(outputDir, "index.d.ts");
-    fs51.writeFileSync(dtsOutputPath, dtsContent);
-    console.log(`Type declarations written to ${path52.relative(projectDir, dtsOutputPath)}`);
+    const dtsOutputPath = path53.join(outputDir, "index.d.ts");
+    fs52.writeFileSync(dtsOutputPath, dtsContent);
+    console.log(`Type declarations written to ${path53.relative(projectDir, dtsOutputPath)}`);
     console.log(kleur_default.green("Transpilation complete!"));
     return true;
   } catch (err) {
@@ -175654,41 +175686,9 @@ var transpileFile = async ({
   }
 };
-// cli/utils/validate-main-in-dist.ts
-import fs52 from "node:fs";
-import path53 from "node:path";
-var validateMainInDist = (projectDir, distDir) => {
-  const packageJsonPath = path53.join(projectDir, "package.json");
-  if (!fs52.existsSync(packageJsonPath))
-    return;
-  const packageJson = JSON.parse(fs52.readFileSync(packageJsonPath, "utf-8"));
-  if (typeof packageJson.main !== "string")
-    return;
-  const resolvedMainPath = path53.resolve(projectDir, packageJson.main);
-  const isMainInDist = resolvedMainPath === distDir || resolvedMainPath.startsWith(`${distDir}${path53.sep}`);
-  if (!isMainInDist) {
-    console.warn('When using transpilation, your package\'s "main" field should point inside the `dist/*` directory, usually to "dist/index.js"');
-  }
-};
-// cli/utils/get-latest-tscircuit-cdn-url.ts
-var TSCIRCUIT_NPMJS_API_URL = "https://registry.npmjs.org/tscircuit/latest";
-async function getLatestTscircuitCdnVersion() {
-  const response = await fetch(TSCIRCUIT_NPMJS_API_URL);
-  if (!response.ok) {
-    throw new Error(`Failed to fetch tscircuit version from CDN: ${response.statusText}`);
-  }
-  const data = await response.json();
-  return data.version;
-}
-async function getLatestTscircuitCdnUrl() {
-  const version2 = await getLatestTscircuitCdnVersion();
-  return `https://cdn.jsdelivr.net/npm/tscircuit@${version2}/dist/browser.min.js`;
-}
 // cli/build/worker-pool.ts
-import path54 from "node:path";
 import fs53 from "node:fs";
+import path54 from "node:path";
 import { Worker } from "node:worker_threads";
 var getWorkerEntrypointPath = () => {
   const tsPath = path54.join(import.meta.dir, "build-worker-entrypoint.ts");
@@ -175709,6 +175709,8 @@ class WorkerPool {
   onLog;
   workerEntrypointPath;
   initialized = false;
+  stopped = false;
+  stopReason = null;
   constructor(options) {
     this.concurrency = options.concurrency;
     this.onLog = options.onLog;
@@ -175779,6 +175781,8 @@ class WorkerPool {
     });
   }
   processQueue() {
+    if (this.stopped)
+      return;
     if (this.jobQueue.length === 0)
       return;
     const availableWorker = this.workers.find((w4) => !w4.busy);
@@ -175799,6 +175803,9 @@ class WorkerPool {
     availableWorker.worker.postMessage(message);
   }
   async queueJob(job) {
+    if (this.stopped) {
+      return Promise.reject(this.stopReason ?? new Error("Worker pool stopped"));
+    }
     await this.initWorkers();
     return new Promise((resolve12, reject) => {
       const queuedJob = {
@@ -175810,6 +175817,16 @@ class WorkerPool {
       this.processQueue();
     });
   }
+  async stop(reason) {
+    if (this.stopped)
+      return;
+    this.stopped = true;
+    this.stopReason = reason;
+    for (const queuedJob of this.jobQueue) {
+      queuedJob.reject(reason);
+    }
+    this.jobQueue = [];
+  }
   async runUntilComplete() {
     return new Promise((resolve12) => {
       const checkComplete = () => {
@@ -175838,22 +175855,31 @@ async function buildFilesWithWorkerPool(options) {
   });
   const results = [];
   const promises = [];
+  const cancellationError = new Error("Build cancelled due fatal error");
   for (const file of options.files) {
     const promise = pool.queueJob({
       filePath: file.filePath,
       outputPath: file.outputPath,
       projectDir: options.projectDir,
       options: options.buildOptions
-    }).then((result) => {
+    }).then(async (result) => {
       results.push(result);
       if (options.onJobComplete) {
-        options.onJobComplete(result);
+        await options.onJobComplete(result);
+      }
+      if (options.stopOnFatal && result.isFatalError) {
+        await pool.stop(cancellationError);
       }
       return result;
     });
     promises.push(promise);
   }
-  await Promise.all(promises);
+  const settledResults = await Promise.allSettled(promises);
+  for (const settledResult of settledResults) {
+    if (settledResult.status === "rejected" && settledResult.reason !== cancellationError) {
+      throw settledResult.reason;
+    }
+  }
   await pool.terminate();
   return results;
 }
@@ -175998,6 +176024,9 @@ var registerBuild = (program3) => {
             console.log(kleur_default.cyan(`[profile] ${relative10}: ${durationMs.toFixed(1)}ms`));
           }
           await processBuildResult(filePath, outputPath, buildOutcome);
+          if (buildOutcome.isFatalError) {
+            break;
+          }
         }
       };
       const buildWithWorkers = async () => {
@@ -176012,6 +176041,7 @@ var registerBuild = (program3) => {
           projectDir,
           concurrency: concurrencyValue,
           buildOptions,
+          stopOnFatal: true,
           onLog: (lines) => {
             for (const line2 of lines) {
               console.log(line2);
@@ -176038,6 +176068,9 @@ var registerBuild = (program3) => {
               ok: result.ok,
               isFatalError: result.isFatalError
             });
+            if (result.isFatalError) {
+              process.exit(1);
+            }
           }
         });
       };