@tscircuit/cli 0.1.900 → 0.1.901

package/dist/cli/main.js

@@ -73493,6 +73493,7 @@ var projectConfigSchema = z.object({
     kicadLibrary: z.boolean().optional(),
     kicadPcm: z.boolean().optional(),
     previewImages: z.boolean().optional(),
+    glbs: z.boolean().optional(),
     typescriptLibrary: z.boolean().optional()
   }).optional()
 });
@@ -74383,7 +74384,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.899";
+var version = "0.1.900";
 var package_default = {
   name: "@tscircuit/cli",
   main: "dist/cli/main.js",
@@ -173892,8 +173893,8 @@ var registerRemove = (program3) => {
 };
 
 // cli/build/register.ts
-import path54 from "node:path";
-import fs53 from "node:fs";
+import path55 from "node:path";
+import fs54 from "node:fs";
 
 // cli/build/build-file.ts
 import path42 from "node:path";
@@ -174241,6 +174242,9 @@ var resolveBuildOptions = ({
   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");
   }
@@ -174250,6 +174254,7 @@ var resolveBuildOptions = ({
     kicadLibrary: cliOptions?.kicadLibrary ?? configBuild?.kicadLibrary,
     kicadPcm: cliOptions?.kicadPcm ?? configBuild?.kicadPcm,
     previewImages: cliOptions?.previewImages ?? configBuild?.previewImages,
+    glbs: cliOptions?.glbs ?? configBuild?.glbs,
     transpile: cliOptions?.transpile ?? configBuild?.typescriptLibrary
   };
   return { options, configAppliedOpts };
@@ -174632,9 +174637,66 @@ var buildPreviewGltf = async ({
   }
 };
 
-// cli/build/generate-kicad-project.ts
+// 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, {
+        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";
 var createKicadProContent = ({
   projectName,
   schematicFileName,
@@ -174674,10 +174736,10 @@ var generateKicadProject = async ({
     boardFileName
   });
   if (writeFiles) {
-    fs48.mkdirSync(outputDir, { recursive: true });
-    fs48.writeFileSync(path49.join(outputDir, schematicFileName), schContent);
-    fs48.writeFileSync(path49.join(outputDir, boardFileName), pcbContent);
-    fs48.writeFileSync(path49.join(outputDir, projectFileName), proContent);
+    fs49.mkdirSync(outputDir, { recursive: true });
+    fs49.writeFileSync(path50.join(outputDir, schematicFileName), schContent);
+    fs49.writeFileSync(path50.join(outputDir, boardFileName), pcbContent);
+    fs49.writeFileSync(path50.join(outputDir, projectFileName), proContent);
   }
   return {
     pcbContent,
@@ -174689,8 +174751,8 @@ var generateKicadProject = async ({
 };
 
 // cli/build/transpile/index.ts
-import path51 from "node:path";
-import fs50 from "node:fs";
+import path52 from "node:path";
+import fs51 from "node:fs";
 import { rollup } from "rollup";
 import typescript from "@rollup/plugin-typescript";
 import resolve11 from "@rollup/plugin-node-resolve";
@@ -174699,11 +174761,11 @@ import json from "@rollup/plugin-json";
 import dts from "rollup-plugin-dts";
 
 // cli/build/transpile/static-asset-plugin.ts
-import fs49 from "node:fs";
-import path50 from "node:path";
+import fs50 from "node:fs";
+import path51 from "node:path";
 import { createHash } from "node:crypto";
 function normalizePathSeparators(filePath) {
-  return filePath.split(path50.sep).join("/");
+  return filePath.split(path51.sep).join("/");
 }
 var STATIC_ASSET_EXTENSIONS = new Set([
   ".glb",
@@ -174734,24 +174796,24 @@ var createStaticAssetPlugin = ({
   return {
     name: "tsci-static-assets",
     resolveId(source, importer) {
-      const ext = path50.extname(source).toLowerCase();
+      const ext = path51.extname(source).toLowerCase();
       if (!STATIC_ASSET_EXTENSIONS.has(ext))
         return null;
-      if (path50.isAbsolute(source)) {
-        return fs49.existsSync(source) ? { id: normalizePathSeparators(source), external: true } : null;
+      if (path51.isAbsolute(source)) {
+        return fs50.existsSync(source) ? { id: normalizePathSeparators(source), external: true } : null;
       }
       if (importer) {
-        const importerNative = importer.split("/").join(path50.sep);
-        const resolvedFromImporter = path50.resolve(path50.dirname(importerNative), source);
-        if (fs49.existsSync(resolvedFromImporter)) {
+        const importerNative = importer.split("/").join(path51.sep);
+        const resolvedFromImporter = path51.resolve(path51.dirname(importerNative), source);
+        if (fs50.existsSync(resolvedFromImporter)) {
           return {
             id: normalizePathSeparators(resolvedFromImporter),
             external: true
           };
         }
       }
-      const resolvedFromProject = path50.resolve(resolvedBaseUrl, source);
-      if (fs49.existsSync(resolvedFromProject)) {
+      const resolvedFromProject = path51.resolve(resolvedBaseUrl, source);
+      if (fs50.existsSync(resolvedFromProject)) {
         return {
           id: normalizePathSeparators(resolvedFromProject),
           external: true
@@ -174764,8 +174826,8 @@ var createStaticAssetPlugin = ({
           const wildcard = isWildcard ? source.slice(patternPrefix.length) : "";
           for (const target of targets) {
             const targetPath = isWildcard ? target.replace("*", wildcard) : target;
-            const resolvedTarget = path50.resolve(resolvedBaseUrl, targetPath);
-            if (fs49.existsSync(resolvedTarget)) {
+            const resolvedTarget = path51.resolve(resolvedBaseUrl, targetPath);
+            if (fs50.existsSync(resolvedTarget)) {
               return {
                 id: normalizePathSeparators(resolvedTarget),
                 external: true
@@ -174791,18 +174853,18 @@ var createStaticAssetPlugin = ({
         if (chunk.type !== "chunk")
           continue;
         for (const importedId of chunk.imports) {
-          const ext = path50.extname(importedId).toLowerCase();
+          const ext = path51.extname(importedId).toLowerCase();
           if (!STATIC_ASSET_EXTENSIONS.has(ext))
             continue;
           if (!copiedAssets.has(importedId)) {
-            const assetDir = path50.join(outputDir, "assets");
-            fs49.mkdirSync(assetDir, { recursive: true });
-            const nativePath = importedId.split("/").join(path50.sep);
-            const fileBuffer = fs49.readFileSync(nativePath);
+            const assetDir = path51.join(outputDir, "assets");
+            fs50.mkdirSync(assetDir, { recursive: true });
+            const nativePath = importedId.split("/").join(path51.sep);
+            const fileBuffer = fs50.readFileSync(nativePath);
             const hash = createHash("sha1").update(fileBuffer).digest("hex").slice(0, 8);
-            const fileName = `${path50.basename(importedId, ext)}-${hash}${ext}`;
-            const outputFilePath = path50.join(assetDir, fileName);
-            fs49.writeFileSync(outputFilePath, fileBuffer);
+            const fileName = `${path51.basename(importedId, ext)}-${hash}${ext}`;
+            const outputFilePath = path51.join(assetDir, fileName);
+            fs50.writeFileSync(outputFilePath, fileBuffer);
             copiedAssets.set(importedId, `./assets/${fileName}`);
             assetIdToOutputPath.set(importedId, `./assets/${fileName}`);
           }
@@ -174824,17 +174886,17 @@ function escapeRegExp(string) {
 
 // cli/build/transpile/index.ts
 var createExternalFunction = (projectDir, tsconfigPath) => (id) => {
-  if (id.startsWith(".") || id.startsWith("/") || path51.isAbsolute(id)) {
+  if (id.startsWith(".") || id.startsWith("/") || path52.isAbsolute(id)) {
     return false;
   }
   let baseUrl = projectDir;
   let pathMappings = {};
-  if (tsconfigPath && fs50.existsSync(tsconfigPath)) {
+  if (tsconfigPath && fs51.existsSync(tsconfigPath)) {
     try {
-      const tsconfigContent = fs50.readFileSync(tsconfigPath, "utf-8");
+      const tsconfigContent = fs51.readFileSync(tsconfigPath, "utf-8");
       const tsconfig = JSON.parse(tsconfigContent);
       if (tsconfig.compilerOptions?.baseUrl) {
-        baseUrl = path51.resolve(path51.dirname(tsconfigPath), tsconfig.compilerOptions.baseUrl);
+        baseUrl = path52.resolve(path52.dirname(tsconfigPath), tsconfig.compilerOptions.baseUrl);
       }
       if (tsconfig.compilerOptions?.paths) {
         pathMappings = tsconfig.compilerOptions.paths;
@@ -174848,17 +174910,17 @@ var createExternalFunction = (projectDir, tsconfigPath) => (id) => {
     }
   }
   const potentialPaths = [
-    path51.join(baseUrl, id),
-    path51.join(baseUrl, `${id}.ts`),
-    path51.join(baseUrl, `${id}.tsx`),
-    path51.join(baseUrl, `${id}.js`),
-    path51.join(baseUrl, `${id}.jsx`),
-    path51.join(baseUrl, id, "index.ts"),
-    path51.join(baseUrl, id, "index.tsx"),
-    path51.join(baseUrl, id, "index.js"),
-    path51.join(baseUrl, id, "index.jsx")
+    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")
   ];
-  if (potentialPaths.some((p4) => fs50.existsSync(p4))) {
+  if (potentialPaths.some((p4) => fs51.existsSync(p4))) {
     return false;
   }
   return true;
@@ -174869,17 +174931,17 @@ var transpileFile = async ({
   projectDir
 }) => {
   try {
-    fs50.mkdirSync(outputDir, { recursive: true });
-    const tsconfigPath = path51.join(projectDir, "tsconfig.json");
-    const hasTsConfig = fs50.existsSync(tsconfigPath);
+    fs51.mkdirSync(outputDir, { recursive: true });
+    const tsconfigPath = path52.join(projectDir, "tsconfig.json");
+    const hasTsConfig = fs51.existsSync(tsconfigPath);
     let tsconfigBaseUrl = projectDir;
     let tsconfigPathMappings;
     if (hasTsConfig) {
       try {
-        const tsconfigContent = fs50.readFileSync(tsconfigPath, "utf-8");
+        const tsconfigContent = fs51.readFileSync(tsconfigPath, "utf-8");
         const tsconfig = JSON.parse(tsconfigContent);
         if (tsconfig.compilerOptions?.baseUrl) {
-          tsconfigBaseUrl = path51.resolve(path51.dirname(tsconfigPath), tsconfig.compilerOptions.baseUrl);
+          tsconfigBaseUrl = path52.resolve(path52.dirname(tsconfigPath), tsconfig.compilerOptions.baseUrl);
         }
         if (tsconfig.compilerOptions?.paths) {
           tsconfigPathMappings = tsconfig.compilerOptions.paths;
@@ -174934,27 +174996,27 @@ var transpileFile = async ({
       external: createExternalFunction(projectDir, hasTsConfig ? tsconfigPath : undefined),
       plugins: getPlugins()
     });
-    const esmOutputPath = path51.join(outputDir, "index.js");
+    const esmOutputPath = path52.join(outputDir, "index.js");
     await esmBundle.write({
       file: esmOutputPath,
       format: "es",
       sourcemap: false
     });
-    console.log(`ESM bundle written to ${path51.relative(projectDir, esmOutputPath)}`);
+    console.log(`ESM bundle written to ${path52.relative(projectDir, esmOutputPath)}`);
     console.log("Building CommonJS bundle...");
     const cjsBundle = await rollup({
       input,
       external: createExternalFunction(projectDir, hasTsConfig ? tsconfigPath : undefined),
       plugins: getPlugins()
     });
-    const cjsOutputPath = path51.join(outputDir, "index.cjs");
+    const cjsOutputPath = path52.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 ${path51.relative(projectDir, cjsOutputPath)}`);
+    console.log(`CommonJS bundle written to ${path52.relative(projectDir, cjsOutputPath)}`);
     console.log("Generating type declarations...");
     const dtsBundle = await rollup({
       input,
@@ -174979,9 +175041,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 = path51.join(outputDir, "index.d.ts");
-    fs50.writeFileSync(dtsOutputPath, dtsContent);
-    console.log(`Type declarations written to ${path51.relative(projectDir, dtsOutputPath)}`);
+    const dtsOutputPath = path52.join(outputDir, "index.d.ts");
+    fs51.writeFileSync(dtsOutputPath, dtsContent);
+    console.log(`Type declarations written to ${path52.relative(projectDir, dtsOutputPath)}`);
     console.log(kleur_default.green("Transpilation complete!"));
     return true;
   } catch (err) {
@@ -174994,17 +175056,17 @@ var transpileFile = async ({
 };
 
 // cli/utils/validate-main-in-dist.ts
-import fs51 from "node:fs";
-import path52 from "node:path";
+import fs52 from "node:fs";
+import path53 from "node:path";
 var validateMainInDist = (projectDir, distDir) => {
-  const packageJsonPath = path52.join(projectDir, "package.json");
-  if (!fs51.existsSync(packageJsonPath))
+  const packageJsonPath = path53.join(projectDir, "package.json");
+  if (!fs52.existsSync(packageJsonPath))
     return;
-  const packageJson = JSON.parse(fs51.readFileSync(packageJsonPath, "utf-8"));
+  const packageJson = JSON.parse(fs52.readFileSync(packageJsonPath, "utf-8"));
   if (typeof packageJson.main !== "string")
     return;
-  const resolvedMainPath = path52.resolve(projectDir, packageJson.main);
-  const isMainInDist = resolvedMainPath === distDir || resolvedMainPath.startsWith(`${distDir}${path52.sep}`);
+  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"');
   }
@@ -175026,19 +175088,19 @@ async function getLatestTscircuitCdnUrl() {
 }
 
 // cli/build/worker-pool.ts
-import path53 from "node:path";
-import fs52 from "node:fs";
+import path54 from "node:path";
+import fs53 from "node:fs";
 import { Worker } from "node:worker_threads";
 var getWorkerEntrypointPath = () => {
-  const tsPath = path53.join(import.meta.dir, "build-worker-entrypoint.ts");
-  if (fs52.existsSync(tsPath)) {
+  const tsPath = path54.join(import.meta.dir, "build-worker-entrypoint.ts");
+  if (fs53.existsSync(tsPath)) {
     return tsPath;
   }
-  const jsBundledPath = path53.join(import.meta.dir, "build", "build-worker-entrypoint.js");
-  if (fs52.existsSync(jsBundledPath)) {
+  const jsBundledPath = path54.join(import.meta.dir, "build", "build-worker-entrypoint.js");
+  if (fs53.existsSync(jsBundledPath)) {
     return jsBundledPath;
   }
-  return path53.join(import.meta.dir, "build-worker-entrypoint.js");
+  return path54.join(import.meta.dir, "build-worker-entrypoint.js");
 };
 
 class WorkerPool {
@@ -175197,25 +175259,25 @@ async function buildFilesWithWorkerPool(options) {
 }
 
 // cli/build/register.ts
-var normalizeRelativePath = (projectDir, targetPath) => path54.relative(projectDir, targetPath).split(path54.sep).join("/");
+var normalizeRelativePath = (projectDir, targetPath) => path55.relative(projectDir, targetPath).split(path55.sep).join("/");
 var registerBuild = (program3) => {
-  program3.command("build").description("Run tscircuit eval and output circuit json").argument("[file]", "Path to the entry file").option("--ci", "Run install and optional prebuild/build commands (or default CI build)").option("--ignore-errors", "Do not exit with code 1 on errors").option("--ignore-warnings", "Do not log warnings").option("--ignore-config", "Ignore options from tscircuit.config.json").option("--disable-pcb", "Disable PCB outputs").option("--disable-parts-engine", "Disable the parts engine").option("--site", "Generate a static site in the dist directory").option("--transpile", "Transpile the entry file to JavaScript").option("--preview-images", "Generate preview images in the dist directory").option("--all-images", "Generate preview images for every successful build output").option("--kicad", "Generate KiCad project directories for each successful build output").option("--kicad-library", "Generate KiCad library in dist/kicad-library").option("--preview-gltf", "Generate a GLTF file from the preview entrypoint").option("--kicad-pcm", "Generate KiCad PCM (Plugin and Content Manager) assets in dist/pcm").option("--use-cdn-javascript", "Use CDN-hosted JavaScript instead of bundled standalone file for --site").option("--concurrency <number>", "Number of files to build in parallel (default: 1)", "1").action(async (file, options) => {
+  program3.command("build").description("Run tscircuit eval and output circuit json").argument("[file]", "Path to the entry file").option("--ci", "Run install and optional prebuild/build commands (or default CI build)").option("--ignore-errors", "Do not exit with code 1 on errors").option("--ignore-warnings", "Do not log warnings").option("--ignore-config", "Ignore options from tscircuit.config.json").option("--disable-pcb", "Disable PCB outputs").option("--disable-parts-engine", "Disable the parts engine").option("--site", "Generate a static site in the dist directory").option("--transpile", "Transpile the entry file to JavaScript").option("--preview-images", "Generate preview images in the dist directory").option("--all-images", "Generate preview images for every successful build output").option("--kicad", "Generate KiCad project directories for each successful build output").option("--kicad-library", "Generate KiCad library in dist/kicad-library").option("--preview-gltf", "Generate a GLTF file from the preview entrypoint").option("--glbs", "Generate GLB 3D model files for every successful build").option("--kicad-pcm", "Generate KiCad PCM (Plugin and Content Manager) assets in dist/pcm").option("--use-cdn-javascript", "Use CDN-hosted JavaScript instead of bundled standalone file for --site").option("--concurrency <number>", "Number of files to build in parallel (default: 1)", "1").action(async (file, options) => {
     try {
-      const resolvedRoot = path54.resolve(process.cwd());
+      const resolvedRoot = path55.resolve(process.cwd());
       let projectDir;
       if (file) {
-        const resolved = path54.resolve(resolvedRoot, file);
-        if (fs53.existsSync(resolved) && fs53.statSync(resolved).isDirectory()) {
+        const resolved = path55.resolve(resolvedRoot, file);
+        if (fs54.existsSync(resolved) && fs54.statSync(resolved).isDirectory()) {
           projectDir = resolvedRoot;
         } else {
-          let currentDir = path54.dirname(resolved);
-          while (currentDir !== path54.dirname(currentDir)) {
-            if (fs53.existsSync(path54.join(currentDir, "package.json"))) {
+          let currentDir = path55.dirname(resolved);
+          while (currentDir !== path55.dirname(currentDir)) {
+            if (fs54.existsSync(path55.join(currentDir, "package.json"))) {
               break;
             }
-            currentDir = path54.dirname(currentDir);
+            currentDir = path55.dirname(currentDir);
           }
-          projectDir = fs53.existsSync(path54.join(currentDir, "package.json")) ? currentDir : resolvedRoot;
+          projectDir = fs54.existsSync(path55.join(currentDir, "package.json")) ? currentDir : resolvedRoot;
         }
       } else {
         projectDir = resolvedRoot;
@@ -175253,8 +175315,8 @@ var registerBuild = (program3) => {
         }
         return config;
       })();
-      const distDir = path54.join(projectDir, "dist");
-      fs53.mkdirSync(distDir, { recursive: true });
+      const distDir = path55.join(projectDir, "dist");
+      fs54.mkdirSync(distDir, { recursive: true });
       const concurrencyValue = Math.max(1, Number.parseInt(resolvedOptions?.concurrency || "1", 10));
       if (concurrencyValue > 1) {
         console.log(`Building ${circuitFiles.length} file(s) with concurrency ${concurrencyValue}...`);
@@ -175273,7 +175335,7 @@ var registerBuild = (program3) => {
         platformConfig: platformConfig2
       };
       const processBuildResult = async (filePath, outputPath, buildOutcome) => {
-        const relative10 = path54.relative(projectDir, filePath);
+        const relative10 = path55.relative(projectDir, filePath);
         const outputDirName = relative10.replace(/(\.board|\.circuit)?\.tsx$/, "");
         builtFiles.push({
           sourcePath: filePath,
@@ -175287,9 +175349,9 @@ var registerBuild = (program3) => {
             console.error(kleur_default.red(`Fatal error [${buildOutcome.isFatalError.errorType}]: ${buildOutcome.isFatalError.message}`));
           }
         } else if (resolvedOptions?.site) {
-          const normalizedSourcePath = relative10.split(path54.sep).join("/");
-          const relativeOutputPath = path54.join(outputDirName, "circuit.json");
-          const normalizedOutputPath = relativeOutputPath.split(path54.sep).join("/");
+          const normalizedSourcePath = relative10.split(path55.sep).join("/");
+          const relativeOutputPath = path55.join(outputDirName, "circuit.json");
+          const normalizedOutputPath = relativeOutputPath.split(path55.sep).join("/");
           staticFileReferences.push({
             filePath: normalizedSourcePath,
             fileStaticAssetUrl: `./${normalizedOutputPath}`
@@ -175297,12 +175359,12 @@ var registerBuild = (program3) => {
         }
         if (buildOutcome.ok && shouldGenerateKicad) {
           let circuitJson = buildOutcome.circuitJson;
-          if (!circuitJson && fs53.existsSync(outputPath)) {
-            circuitJson = JSON.parse(fs53.readFileSync(outputPath, "utf-8"));
+          if (!circuitJson && fs54.existsSync(outputPath)) {
+            circuitJson = JSON.parse(fs54.readFileSync(outputPath, "utf-8"));
           }
           if (circuitJson) {
-            const projectOutputDir = path54.join(distDir, outputDirName, "kicad");
-            const projectName = path54.basename(outputDirName);
+            const projectOutputDir = path55.join(distDir, outputDirName, "kicad");
+            const projectName = path55.basename(outputDirName);
             const project = await generateKicadProject({
               circuitJson,
               outputDir: projectOutputDir,
@@ -175318,19 +175380,19 @@ var registerBuild = (program3) => {
       };
       const buildSequentially = async () => {
         for (const filePath of circuitFiles) {
-          const relative10 = path54.relative(projectDir, filePath);
+          const relative10 = path55.relative(projectDir, filePath);
           console.log(`Building ${relative10}...`);
           const outputDirName = relative10.replace(/(\.board|\.circuit)?\.tsx$/, "");
-          const outputPath = path54.join(distDir, outputDirName, "circuit.json");
+          const outputPath = path55.join(distDir, outputDirName, "circuit.json");
           const buildOutcome = await buildFile(filePath, outputPath, projectDir, buildOptions);
           await processBuildResult(filePath, outputPath, buildOutcome);
         }
       };
       const buildWithWorkers = async () => {
         const filesToBuild = circuitFiles.map((filePath) => {
-          const relative10 = path54.relative(projectDir, filePath);
+          const relative10 = path55.relative(projectDir, filePath);
           const outputDirName = relative10.replace(/(\.board|\.circuit)?\.tsx$/, "");
-          const outputPath = path54.join(distDir, outputDirName, "circuit.json");
+          const outputPath = path55.join(distDir, outputDirName, "circuit.json");
           return { filePath, outputPath };
         });
         await buildFilesWithWorkerPool({
@@ -175344,7 +175406,7 @@ var registerBuild = (program3) => {
             }
           },
           onJobComplete: async (result) => {
-            const relative10 = path54.relative(projectDir, result.filePath);
+            const relative10 = path55.relative(projectDir, result.filePath);
             if (result.ok) {
               console.log(kleur_default.green(`✓ ${relative10}`));
             } else {
@@ -175388,6 +175450,13 @@ var registerBuild = (program3) => {
           previewComponentPath
         });
       }
+      if (resolvedOptions?.glbs) {
+        console.log("Generating GLB models for all builds...");
+        await buildGlbs({
+          builtFiles,
+          distDir
+        });
+      }
       if (resolvedOptions?.transpile) {
         validateMainInDist(projectDir, distDir);
         console.log("Transpiling entry file...");
@@ -175415,14 +175484,14 @@ var registerBuild = (program3) => {
         if (resolvedOptions?.useCdnJavascript) {
           standaloneScriptSrc = await getLatestTscircuitCdnUrl();
         } else {
-          fs53.writeFileSync(path54.join(distDir, "standalone.min.js"), standalone_min_default);
+          fs54.writeFileSync(path55.join(distDir, "standalone.min.js"), standalone_min_default);
         }
         const indexHtml = getStaticIndexHtmlFile({
           files: staticFileReferences,
           standaloneScriptSrc,
           defaultMainComponentPath: siteDefaultComponentPath ? normalizeRelativePath(projectDir, siteDefaultComponentPath) : undefined
         });
-        fs53.writeFileSync(path54.join(distDir, "index.html"), indexHtml);
+        fs54.writeFileSync(path55.join(distDir, "index.html"), indexHtml);
       }
       if (resolvedOptions?.kicadLibrary) {
         console.log("Generating KiCad library...");
@@ -175442,14 +175511,14 @@ var registerBuild = (program3) => {
           }
         } else {
           const libraryName = resolveKicadLibraryName({ projectDir });
-          const kicadLibOutputDir = path54.join(distDir, "kicad-library");
+          const kicadLibOutputDir = path55.join(distDir, "kicad-library");
           try {
             await convertToKicadLibrary({
               filePath: entryFile,
               libraryName,
               outputDir: kicadLibOutputDir
             });
-            console.log(`  KiCad library generated at ${kleur_default.dim(path54.relative(process.cwd(), kicadLibOutputDir))}`);
+            console.log(`  KiCad library generated at ${kleur_default.dim(path55.relative(process.cwd(), kicadLibOutputDir))}`);
           } catch (err) {
             console.error(`Error generating KiCad library: ${err instanceof Error ? err.message : err}`);
             if (!resolvedOptions?.ignoreErrors) {
@@ -175496,6 +175565,7 @@ var registerBuild = (program3) => {
         resolvedOptions?.transpile && "transpile",
         resolvedOptions?.previewImages && "preview-images",
         resolvedOptions?.allImages && "all-images",
+        resolvedOptions?.glbs && "glbs",
         resolvedOptions?.kicad && "kicad",
         resolvedOptions?.kicadLibrary && "kicad-library",
         resolvedOptions?.kicadPcm && "kicad-pcm",
@@ -175510,7 +175580,7 @@ var registerBuild = (program3) => {
       if (configAppliedOpts.length > 0) {
         console.log(`  Config    ${kleur_default.magenta(configAppliedOpts.join(", "))} ${kleur_default.dim("(from tscircuit.config.json)")}`);
       }
-      console.log(`  Output    ${kleur_default.dim(path54.relative(process.cwd(), distDir) || "dist")}`);
+      console.log(`  Output    ${kleur_default.dim(path55.relative(process.cwd(), distDir) || "dist")}`);
       console.log(hasErrors ? kleur_default.yellow(`
 ⚠ Build completed with errors`) : kleur_default.green(`
 ✓ Done`));
@@ -175524,19 +175594,19 @@ var registerBuild = (program3) => {
 };
 
 // lib/shared/snapshot-project.ts
-import fs55 from "node:fs";
-import path55 from "node:path";
+import fs56 from "node:fs";
+import path56 from "node:path";
 import looksSame2 from "looks-same";
 import {
   convertCircuitJsonToPcbSvg as convertCircuitJsonToPcbSvg3,
   convertCircuitJsonToSchematicSvg as convertCircuitJsonToSchematicSvg3
 } from "circuit-to-svg";
-import { convertCircuitJsonToGltf as convertCircuitJsonToGltf4 } from "circuit-json-to-gltf";
+import { convertCircuitJsonToGltf as convertCircuitJsonToGltf5 } from "circuit-json-to-gltf";
 import { renderGLTFToPNGBufferFromGLBBuffer as renderGLTFToPNGBufferFromGLBBuffer2 } from "poppygl";
 
 // lib/shared/compare-images.ts
 import looksSame from "looks-same";
-import fs54 from "node:fs/promises";
+import fs55 from "node:fs/promises";
 var compareAndCreateDiff = async (buffer1, buffer2, diffPath) => {
   const { equal: equal2 } = await looksSame(buffer1, buffer2, {
     strict: false,
@@ -175552,7 +175622,7 @@ var compareAndCreateDiff = async (buffer1, buffer2, diffPath) => {
         tolerance: 2
       });
     } else {
-      await fs54.writeFile(diffPath, buffer2);
+      await fs55.writeFile(diffPath, buffer2);
     }
   }
   return { equal: equal2 };
@@ -175577,7 +175647,7 @@ var snapshotProject = async ({
     ...DEFAULT_IGNORED_PATTERNS,
     ...ignored.map(normalizeIgnorePattern)
   ];
-  const resolvedPaths = filePaths.map((f2) => path55.resolve(projectDir, f2));
+  const resolvedPaths = filePaths.map((f2) => path56.resolve(projectDir, f2));
   const boardFiles = findBoardFiles({
     projectDir,
     ignore,
@@ -175591,7 +175661,7 @@ var snapshotProject = async ({
   const mismatches = [];
   let didUpdate = false;
   for (const file of boardFiles) {
-    const relativeFilePath = path55.relative(projectDir, file);
+    const relativeFilePath = path56.relative(projectDir, file);
     let circuitJson;
     let pcbSvg;
     let schSvg;
@@ -175633,7 +175703,7 @@ var snapshotProject = async ({
     let png3d = null;
     if (threeD) {
       try {
-        const glbBuffer = await convertCircuitJsonToGltf4(circuitJson, {
+        const glbBuffer = await convertCircuitJsonToGltf5(circuitJson, {
           format: "glb"
         });
         if (!(glbBuffer instanceof ArrayBuffer)) {
@@ -175646,17 +175716,17 @@ var snapshotProject = async ({
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         if (errorMessage.includes("No pcb_board found in circuit JSON")) {
-          const fileDir = path55.dirname(file);
-          const relativeDir = path55.relative(projectDir, fileDir);
-          const snapDir2 = snapshotsDirName ? path55.join(projectDir, snapshotsDirName, relativeDir) : path55.join(fileDir, "__snapshots__");
-          const base2 = path55.basename(file).replace(/\.tsx$/, "");
-          const snap3dPath = path55.join(snapDir2, `${base2}-3d.snap.png`);
-          const existing3dSnapshot = fs55.existsSync(snap3dPath);
+          const fileDir = path56.dirname(file);
+          const relativeDir = path56.relative(projectDir, fileDir);
+          const snapDir2 = snapshotsDirName ? path56.join(projectDir, snapshotsDirName, relativeDir) : path56.join(fileDir, "__snapshots__");
+          const base2 = path56.basename(file).replace(/\.tsx$/, "");
+          const snap3dPath = path56.join(snapDir2, `${base2}-3d.snap.png`);
+          const existing3dSnapshot = fs56.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: ${path55.relative(projectDir, snap3dPath)}
+`) + kleur_default.red(`   Existing snapshot: ${path56.relative(projectDir, snap3dPath)}
 `));
             return onExit2(1);
           } else {
@@ -175672,9 +175742,9 @@ var snapshotProject = async ({
         }
       }
     }
-    const snapDir = snapshotsDirName ? path55.join(projectDir, snapshotsDirName, path55.relative(projectDir, path55.dirname(file))) : path55.join(path55.dirname(file), "__snapshots__");
-    fs55.mkdirSync(snapDir, { recursive: true });
-    const base = path55.basename(file).replace(/\.tsx$/, "");
+    const snapDir = snapshotsDirName ? path56.join(projectDir, snapshotsDirName, path56.relative(projectDir, path56.dirname(file))) : path56.join(path56.dirname(file), "__snapshots__");
+    fs56.mkdirSync(snapDir, { recursive: true });
+    const base = path56.basename(file).replace(/\.tsx$/, "");
     const snapshots = [];
     if (pcbOnly || !schematicOnly) {
       snapshots.push({ type: "pcb", content: pcbSvg, isBinary: false });
@@ -175692,31 +175762,31 @@ var snapshotProject = async ({
     for (const snapshot of snapshots) {
       const { type } = snapshot;
       const is3d = type === "3d";
-      const snapPath = path55.join(snapDir, `${base}-${type}.snap.${is3d ? "png" : "svg"}`);
-      const existing = fs55.existsSync(snapPath);
+      const snapPath = path56.join(snapDir, `${base}-${type}.snap.${is3d ? "png" : "svg"}`);
+      const existing = fs56.existsSync(snapPath);
       const newContentBuffer = snapshot.isBinary ? snapshot.content : Buffer.from(snapshot.content, "utf8");
       const newContentForFile = snapshot.content;
       if (!existing) {
-        fs55.writeFileSync(snapPath, newContentForFile);
-        console.log("✅", kleur_default.gray(path55.relative(projectDir, snapPath)));
+        fs56.writeFileSync(snapPath, newContentForFile);
+        console.log("✅", kleur_default.gray(path56.relative(projectDir, snapPath)));
         didUpdate = true;
         continue;
       }
-      const oldContentBuffer = fs55.readFileSync(snapPath);
+      const oldContentBuffer = fs56.readFileSync(snapPath);
       const diffPath = snapPath.replace(is3d ? ".snap.png" : ".snap.svg", is3d ? ".diff.png" : ".diff.svg");
       const { equal: equal2 } = await compareAndCreateDiff(oldContentBuffer, newContentBuffer, diffPath);
       if (update) {
         if (!forceUpdate && equal2) {
-          console.log("✅", kleur_default.gray(path55.relative(projectDir, snapPath)));
+          console.log("✅", kleur_default.gray(path56.relative(projectDir, snapPath)));
         } else {
-          fs55.writeFileSync(snapPath, newContentForFile);
-          console.log("✅", kleur_default.gray(path55.relative(projectDir, snapPath)));
+          fs56.writeFileSync(snapPath, newContentForFile);
+          console.log("✅", kleur_default.gray(path56.relative(projectDir, snapPath)));
           didUpdate = true;
         }
       } else if (!equal2) {
         mismatches.push(`${snapPath} (diff: ${diffPath})`);
       } else {
-        console.log("✅", kleur_default.gray(path55.relative(projectDir, snapPath)));
+        console.log("✅", kleur_default.gray(path56.relative(projectDir, snapPath)));
       }
     }
   }
@@ -175755,22 +175825,22 @@ var registerSnapshot = (program3) => {
 };
 
 // lib/shared/setup-github-actions.ts
-import fs56 from "node:fs";
-import path56 from "node:path";
+import fs57 from "node:fs";
+import path57 from "node:path";
 var setupGithubActions = (projectDir = process.cwd()) => {
   const findGitRoot = (startDir) => {
-    let dir = path56.resolve(startDir);
-    while (dir !== path56.parse(dir).root) {
-      if (fs56.existsSync(path56.join(dir, ".git"))) {
+    let dir = path57.resolve(startDir);
+    while (dir !== path57.parse(dir).root) {
+      if (fs57.existsSync(path57.join(dir, ".git"))) {
         return dir;
       }
-      dir = path56.dirname(dir);
+      dir = path57.dirname(dir);
     }
     return null;
   };
   const gitRoot = findGitRoot(projectDir) ?? projectDir;
-  const workflowsDir = path56.join(gitRoot, ".github", "workflows");
-  fs56.mkdirSync(workflowsDir, { recursive: true });
+  const workflowsDir = path57.join(gitRoot, ".github", "workflows");
+  fs57.mkdirSync(workflowsDir, { recursive: true });
   const buildWorkflow = `name: tscircuit Build
 
 on:
@@ -175809,8 +175879,8 @@ jobs:
       - run: bun install
       - run: bunx tsci snapshot
 `;
-  writeFileIfNotExists(path56.join(workflowsDir, "tscircuit-build.yml"), buildWorkflow);
-  writeFileIfNotExists(path56.join(workflowsDir, "tscircuit-snapshot.yml"), snapshotWorkflow);
+  writeFileIfNotExists(path57.join(workflowsDir, "tscircuit-build.yml"), buildWorkflow);
+  writeFileIfNotExists(path57.join(workflowsDir, "tscircuit-snapshot.yml"), snapshotWorkflow);
 };
 
 // cli/setup/register.ts
@@ -175848,8 +175918,8 @@ function registerAuthSetupNpmrc(program3) {
 }
 
 // cli/convert/register.ts
-import fs57 from "node:fs/promises";
-import path57 from "node:path";
+import fs58 from "node:fs/promises";
+import path58 from "node:path";
 import { parseKicadModToCircuitJson } from "kicad-component-converter";
 
 // node_modules/@tscircuit/mm/dist/index.js
@@ -175970,15 +176040,15 @@ var convertCircuitJsonToTscircuit = (circuitJson, opts) => {
 var registerConvert = (program3) => {
   program3.command("convert").description("Convert a .kicad_mod footprint to a tscircuit component").argument("<file>", "Path to the .kicad_mod file").option("-o, --output <path>", "Output TSX file path").option("-n, --name <component>", "Component name for export").action(async (file, options) => {
     try {
-      const inputPath = path57.resolve(file);
-      const modContent = await fs57.readFile(inputPath, "utf-8");
+      const inputPath = path58.resolve(file);
+      const modContent = await fs58.readFile(inputPath, "utf-8");
       const circuitJson = await parseKicadModToCircuitJson(modContent);
-      const componentName = options.name ?? path57.basename(inputPath, ".kicad_mod");
+      const componentName = options.name ?? path58.basename(inputPath, ".kicad_mod");
       const tsx = convertCircuitJsonToTscircuit(circuitJson, {
         componentName
       });
-      const outputPath = options.output ? path57.resolve(options.output) : path57.join(path57.dirname(inputPath), `${componentName}.tsx`);
-      await fs57.writeFile(outputPath, tsx);
+      const outputPath = options.output ? path58.resolve(options.output) : path58.join(path58.dirname(inputPath), `${componentName}.tsx`);
+      await fs58.writeFile(outputPath, tsx);
       console.log(kleur_default.green(`Converted ${outputPath}`));
     } catch (error) {
       console.error(kleur_default.red("Failed to convert footprint:"), error instanceof Error ? error.message : error);
@@ -176094,7 +176164,7 @@ var registerInstall = (program3) => {
 };
 
 // cli/transpile/register.ts
-import path58 from "node:path";
+import path59 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 {
@@ -176102,7 +176172,7 @@ var registerTranspile = (program3) => {
         fileOrDir: file,
         includeBoardFiles: false
       });
-      const distDir = path58.join(projectDir, "dist");
+      const distDir = path59.join(projectDir, "dist");
       validateMainInDist(projectDir, distDir);
       console.log("Transpiling entry file...");
       const entryFile = mainEntrypoint || circuitFiles[0];
@@ -176130,8 +176200,8 @@ var registerTranspile = (program3) => {
 };
 
 // lib/shared/register-static-asset-loaders.ts
-import fs58 from "node:fs";
-import path59 from "node:path";
+import fs59 from "node:fs";
+import path60 from "node:path";
 var STATIC_ASSET_EXTENSIONS2 = [
   ".glb",
   ".gltf",
@@ -176144,12 +176214,12 @@ var STATIC_ASSET_EXTENSIONS2 = [
 var staticAssetFilter = new RegExp(`(${STATIC_ASSET_EXTENSIONS2.map((ext) => ext.replace(".", "\\.")).join("|")})$`, "i");
 var registered = false;
 var getBaseUrlFromTsConfig = () => {
-  const tsconfigPath = path59.join(process.cwd(), "tsconfig.json");
+  const tsconfigPath = path60.join(process.cwd(), "tsconfig.json");
   try {
-    if (!fs58.existsSync(tsconfigPath)) {
+    if (!fs59.existsSync(tsconfigPath)) {
       return null;
     }
-    const tsconfigContent = fs58.readFileSync(tsconfigPath, "utf-8");
+    const tsconfigContent = fs59.readFileSync(tsconfigPath, "utf-8");
     const tsconfig = JSON.parse(tsconfigContent);
     if (tsconfig.compilerOptions?.baseUrl) {
       return tsconfig.compilerOptions.baseUrl;
@@ -176167,8 +176237,8 @@ var registerStaticAssetLoaders = () => {
       name: "tsci-static-assets",
       setup(build) {
         build.onLoad({ filter: staticAssetFilter }, (args) => {
-          const baseDir = baseUrl ? path59.resolve(process.cwd(), baseUrl) : process.cwd();
-          const relativePath = path59.relative(baseDir, args.path).split(path59.sep).join("/");
+          const baseDir = baseUrl ? path60.resolve(process.cwd(), baseUrl) : process.cwd();
+          const relativePath = path60.relative(baseDir, args.path).split(path60.sep).join("/");
           const pathStr = `./${relativePath}`;
           return {
             exports: {
@@ -176199,15 +176269,15 @@ var checkLoggedIn = () => {
 
 // cli/doctor/checks/check-npmrc-registry.ts
 import { spawnSync } from "node:child_process";
-import fs59 from "node:fs";
+import fs60 from "node:fs";
 import os9 from "node:os";
-import path60 from "node:path";
+import path61 from "node:path";
 var hasBunInstalled = () => {
   const result = spawnSync("bun", ["--version"], { stdio: "ignore" });
   return result.status === 0;
 };
 var createTempProject = (tempDir) => {
-  const packageJsonPath = path60.join(tempDir, "package.json");
+  const packageJsonPath = path61.join(tempDir, "package.json");
   const packageJson = {
     name: "tsci-doctor-check",
     version: "0.0.0",
@@ -176216,7 +176286,7 @@ var createTempProject = (tempDir) => {
       "@tsci/does-not-exist": "0.0.0"
     }
   };
-  fs59.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+  fs60.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
 };
 var checkGlobalNpmrcRegistry = async () => {
   const name = "Global .npmrc configured for tscircuit NPM registry?";
@@ -176227,7 +176297,7 @@ var checkGlobalNpmrcRegistry = async () => {
       details: "Bun is required to verify registry settings. Install Bun and rerun `tsci doctor`."
     };
   }
-  const tempDir = fs59.mkdtempSync(path60.join(os9.tmpdir(), "tsci-doctor-"));
+  const tempDir = fs60.mkdtempSync(path61.join(os9.tmpdir(), "tsci-doctor-"));
   try {
     createTempProject(tempDir);
     const result = spawnSync("bun", ["install"], {
@@ -176265,7 +176335,7 @@ ${result.stderr ?? ""}`;
     }
     return { name, success: true };
   } finally {
-    fs59.rmSync(tempDir, { recursive: true, force: true });
+    fs60.rmSync(tempDir, { recursive: true, force: true });
   }
 };
 

package/dist/lib/index.js

@@ -60414,7 +60414,7 @@ var getNodeHandler = (winterSpec, { port, middleware = [] }) => {
   }));
 };
 // package.json
-var version = "0.1.899";
+var version = "0.1.900";
 var package_default = {
   name: "@tscircuit/cli",
   main: "dist/cli/main.js",
@@ -67075,6 +67075,7 @@ var projectConfigSchema = z21.object({
     kicadLibrary: z21.boolean().optional(),
     kicadPcm: z21.boolean().optional(),
     previewImages: z21.boolean().optional(),
+    glbs: z21.boolean().optional(),
     typescriptLibrary: z21.boolean().optional()
   }).optional()
 });

package/package.json

@@ -5,7 +5,7 @@
     ".": "./dist/cli/main.js",
     "./lib": "./dist/lib/index.js"
   },
-  "version": "0.1.900",
+  "version": "0.1.901",
   "devDependencies": {
     "@babel/standalone": "^7.26.9",
     "@biomejs/biome": "^1.9.4",

package/types/tscircuit.config.schema.json

@@ -80,6 +80,10 @@
           "type": "boolean",
           "description": "Enable preview image outputs in build."
         },
+        "glbs": {
+          "type": "boolean",
+          "description": "Enable GLB 3D model outputs for each circuit in build."
+        },
         "typescriptLibrary": {
           "type": "boolean",
           "description": "Enable TypeScript library output in build."