@tscircuit/cli 0.1.2383 → 0.1.2384

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

@@ -31934,11 +31934,28 @@ var kicadPcmSettingsSchema = z.object({
   schemaVersion: z.union([z.literal("auto"), z.literal(1), z.literal(2)]).optional(),
   license: z.string().trim().min(1).optional()
 });
+var extraRunFrameTabSchema = z.object({
+  tabName: z.string().trim().min(1),
+  iframeUrl: z.string().url().refine((url) => /^https?:\/\//i.test(url), {
+    message: "Extra RunFrame tabs require an HTTP or HTTPS URL"
+  }).refine((url) => {
+    try {
+      const parsed = new URL(url);
+      return !parsed.username && !parsed.password;
+    } catch {
+      return false;
+    }
+  }, {
+    message: "Extra RunFrame tab URLs must not include credentials"
+  }),
+  mainComponentPath: z.string().trim().min(1).optional()
+});
 var projectConfigSchema = z.object({
   mainEntrypoint: z.string().optional(),
   libraryEntrypoint: z.string().optional(),
   previewComponentPath: z.string().optional(),
   siteDefaultComponentPath: z.string().optional(),
+  extraRunFrameTabs: z.array(extraRunFrameTabSchema).optional(),
   ignoredFiles: z.array(z.string()).optional(),
   includeBoardFiles: z.array(z.string()).optional(),
   snapshotsDir: z.string().optional(),
@@ -32021,7 +32038,7 @@ var loadProjectEnv = (projectDir) => {
     }
   }
 };
-var loadProjectConfigSync = (projectDir = process.cwd()) => {
+var loadProjectConfigSync = (projectDir = process.cwd(), options = {}) => {
   const configPath = path.join(projectDir, CONFIG_FILENAME);
   if (!fs.existsSync(configPath)) {
     return null;
@@ -32031,11 +32048,13 @@ var loadProjectConfigSync = (projectDir = process.cwd()) => {
     const parsedConfig = JSON.parse(configContent);
     return projectConfigSchema.parse(parsedConfig);
   } catch (error) {
+    if (options.throwOnError)
+      throw error;
     console.error(`Error loading tscircuit config: ${error}`);
     return null;
   }
 };
-var loadProjectConfigModule = async (projectDir) => {
+var loadProjectConfigModule = async (projectDir, options = {}) => {
   loadProjectEnv(projectDir);
   for (const configFileName of CONFIG_MODULE_FILENAMES) {
     const configPath = path.join(projectDir, configFileName);
@@ -32049,15 +32068,17 @@ var loadProjectConfigModule = async (projectDir) => {
       const exportedConfig = importedModule.default ?? importedModule.config ?? importedModule;
       return parseProjectConfigObject(exportedConfig);
     } catch (error) {
+      if (options.throwOnError)
+        throw error;
       console.error(`Error loading ${configFileName}: ${error}`);
       return null;
     }
   }
   return null;
 };
-var loadRuntimeProjectConfig = async (projectDir = process.cwd()) => {
-  const jsonConfig = loadProjectConfigSync(projectDir);
-  const moduleConfig = await loadProjectConfigModule(projectDir);
+var loadRuntimeProjectConfig = async (projectDir = process.cwd(), options = {}) => {
+  const jsonConfig = loadProjectConfigSync(projectDir, options);
+  const moduleConfig = await loadProjectConfigModule(projectDir, options);
   if (!jsonConfig && !moduleConfig) {
     return null;
   }

package/dist/cli/main.js

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/dist/cli/main.js
-size: 46978861 bytes
-sha256: 9726711e7ad7dcde3c882b7a13ad1de482fc5c9450beebf7060851d0b715428c
+size: 46985125 bytes
+sha256: 584e5dd10a58d0cf85334e1312bdd66756b6861e01c1b3db2a917a0ab7d7bba6

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

@@ -24799,11 +24799,28 @@ var kicadPcmSettingsSchema = z.object({
   schemaVersion: z.union([z.literal("auto"), z.literal(1), z.literal(2)]).optional(),
   license: z.string().trim().min(1).optional()
 });
+var extraRunFrameTabSchema = z.object({
+  tabName: z.string().trim().min(1),
+  iframeUrl: z.string().url().refine((url) => /^https?:\/\//i.test(url), {
+    message: "Extra RunFrame tabs require an HTTP or HTTPS URL"
+  }).refine((url) => {
+    try {
+      const parsed = new URL(url);
+      return !parsed.username && !parsed.password;
+    } catch {
+      return false;
+    }
+  }, {
+    message: "Extra RunFrame tab URLs must not include credentials"
+  }),
+  mainComponentPath: z.string().trim().min(1).optional()
+});
 var projectConfigSchema = z.object({
   mainEntrypoint: z.string().optional(),
   libraryEntrypoint: z.string().optional(),
   previewComponentPath: z.string().optional(),
   siteDefaultComponentPath: z.string().optional(),
+  extraRunFrameTabs: z.array(extraRunFrameTabSchema).optional(),
   ignoredFiles: z.array(z.string()).optional(),
   includeBoardFiles: z.array(z.string()).optional(),
   snapshotsDir: z.string().optional(),
@@ -24886,7 +24903,7 @@ var loadProjectEnv = (projectDir) => {
     }
   }
 };
-var loadProjectConfigSync = (projectDir = process.cwd()) => {
+var loadProjectConfigSync = (projectDir = process.cwd(), options = {}) => {
   const configPath = path10.join(projectDir, CONFIG_FILENAME);
   if (!fs11.existsSync(configPath)) {
     return null;
@@ -24896,11 +24913,13 @@ var loadProjectConfigSync = (projectDir = process.cwd()) => {
     const parsedConfig = JSON.parse(configContent);
     return projectConfigSchema.parse(parsedConfig);
   } catch (error) {
+    if (options.throwOnError)
+      throw error;
     console.error(`Error loading tscircuit config: ${error}`);
     return null;
   }
 };
-var loadProjectConfigModule = async (projectDir) => {
+var loadProjectConfigModule = async (projectDir, options = {}) => {
   loadProjectEnv(projectDir);
   for (const configFileName of CONFIG_MODULE_FILENAMES) {
     const configPath = path10.join(projectDir, configFileName);
@@ -24914,15 +24933,17 @@ var loadProjectConfigModule = async (projectDir) => {
       const exportedConfig = importedModule.default ?? importedModule.config ?? importedModule;
       return parseProjectConfigObject(exportedConfig);
     } catch (error) {
+      if (options.throwOnError)
+        throw error;
       console.error(`Error loading ${configFileName}: ${error}`);
       return null;
     }
   }
   return null;
 };
-var loadRuntimeProjectConfig = async (projectDir = process.cwd()) => {
-  const jsonConfig = loadProjectConfigSync(projectDir);
-  const moduleConfig = await loadProjectConfigModule(projectDir);
+var loadRuntimeProjectConfig = async (projectDir = process.cwd(), options = {}) => {
+  const jsonConfig = loadProjectConfigSync(projectDir, options);
+  const moduleConfig = await loadProjectConfigModule(projectDir, options);
   if (!jsonConfig && !moduleConfig) {
     return null;
   }

package/dist/lib/index.js

@@ -71847,8 +71847,16 @@ var getPartsEngineBaseUrls = () => {
   return baseUrls;
 };
 
+// lib/site/serialize-script-value.ts
+var serializeScriptValue = (value) => JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+
 // lib/site/getIndex.ts
-var getIndex = async (mainComponentPath, fileServerApiBaseUrl, jscdnBaseUrl) => {
+var getIndex = async ({
+  mainComponentPath,
+  fileServerApiBaseUrl,
+  jscdnBaseUrl,
+  extraRunFrameTabs = []
+} = {}) => {
   const standalone = process.env.TSCIRCUIT_STANDALONE === "1";
   const evalVersion = package_default.devDependencies["@tscircuit/eval"];
   const standaloneScript = standalone ? `
@@ -71872,14 +71880,16 @@ var getIndex = async (mainComponentPath, fileServerApiBaseUrl, jscdnBaseUrl) =>
     </head>
     <body>
       <script>
-       ${mainComponentPath ? `window.TSCIRCUIT_DEFAULT_MAIN_COMPONENT_PATH = "${mainComponentPath}";` : ""}
+       ${mainComponentPath ? `window.TSCIRCUIT_DEFAULT_MAIN_COMPONENT_PATH = ${serializeScriptValue(mainComponentPath)};` : ""}
         window.TSCIRCUIT_USE_RUNFRAME_FOR_CLI = true;${tokenScript}${fileServerApiScript}${jscdnScript}${partsEngineScript}${standaloneScript}
+        window.TSCIRCUIT_EXTRA_RUNFRAME_TABS = ${serializeScriptValue(extraRunFrameTabs)};
       </script>
       ${standalone ? "" : '<script src="https://cdn.tailwindcss.com"></script>'}
       <div id="root">loading...</div>
       <script>
       globalThis.process = { env: { NODE_ENV: "production" } }
       </script>
+      ${fileServerApiBaseUrl ? '<script src="/extra-runframe-tabs.js" defer></script>' : ""}
       <script type="module" src="/standalone.min.js"></script>
     </body>
   </html>`;
@@ -79942,11 +79952,28 @@ var kicadPcmSettingsSchema = z21.object({
   schemaVersion: z21.union([z21.literal("auto"), z21.literal(1), z21.literal(2)]).optional(),
   license: z21.string().trim().min(1).optional()
 });
+var extraRunFrameTabSchema = z21.object({
+  tabName: z21.string().trim().min(1),
+  iframeUrl: z21.string().url().refine((url) => /^https?:\/\//i.test(url), {
+    message: "Extra RunFrame tabs require an HTTP or HTTPS URL"
+  }).refine((url) => {
+    try {
+      const parsed = new URL(url);
+      return !parsed.username && !parsed.password;
+    } catch {
+      return false;
+    }
+  }, {
+    message: "Extra RunFrame tab URLs must not include credentials"
+  }),
+  mainComponentPath: z21.string().trim().min(1).optional()
+});
 var projectConfigSchema = z21.object({
   mainEntrypoint: z21.string().optional(),
   libraryEntrypoint: z21.string().optional(),
   previewComponentPath: z21.string().optional(),
   siteDefaultComponentPath: z21.string().optional(),
+  extraRunFrameTabs: z21.array(extraRunFrameTabSchema).optional(),
   ignoredFiles: z21.array(z21.string()).optional(),
   includeBoardFiles: z21.array(z21.string()).optional(),
   snapshotsDir: z21.string().optional(),
@@ -80029,7 +80056,7 @@ var loadProjectEnv = (projectDir) => {
     }
   }
 };
-var loadProjectConfigSync = (projectDir = process.cwd()) => {
+var loadProjectConfigSync = (projectDir = process.cwd(), options = {}) => {
   const configPath = path11.join(projectDir, CONFIG_FILENAME);
   if (!fs9.existsSync(configPath)) {
     return null;
@@ -80039,11 +80066,13 @@ var loadProjectConfigSync = (projectDir = process.cwd()) => {
     const parsedConfig = JSON.parse(configContent);
     return projectConfigSchema.parse(parsedConfig);
   } catch (error) {
+    if (options.throwOnError)
+      throw error;
     console.error(`Error loading tscircuit config: ${error}`);
     return null;
   }
 };
-var loadProjectConfigModule = async (projectDir) => {
+var loadProjectConfigModule = async (projectDir, options = {}) => {
   loadProjectEnv(projectDir);
   for (const configFileName of CONFIG_MODULE_FILENAMES) {
     const configPath = path11.join(projectDir, configFileName);
@@ -80057,15 +80086,17 @@ var loadProjectConfigModule = async (projectDir) => {
       const exportedConfig = importedModule.default ?? importedModule.config ?? importedModule;
       return parseProjectConfigObject(exportedConfig);
     } catch (error) {
+      if (options.throwOnError)
+        throw error;
       console.error(`Error loading ${configFileName}: ${error}`);
       return null;
     }
   }
   return null;
 };
-var loadRuntimeProjectConfig = async (projectDir = process.cwd()) => {
-  const jsonConfig = loadProjectConfigSync(projectDir);
-  const moduleConfig = await loadProjectConfigModule(projectDir);
+var loadRuntimeProjectConfig = async (projectDir = process.cwd(), options = {}) => {
+  const jsonConfig = loadProjectConfigSync(projectDir, options);
+  const moduleConfig = await loadProjectConfigModule(projectDir, options);
   if (!jsonConfig && !moduleConfig) {
     return null;
   }
@@ -80846,6 +80877,84 @@ var copyJscdnFiles = async (sourceDir, outputDir) => {
   await cp(source, output, { recursive: true, dereference: true });
 };
 
+// lib/server/read-extra-runframe-tabs.ts
+async function readExtraRunFrameTabs(projectDir) {
+  const config = projectDir ? await loadRuntimeProjectConfig(projectDir, { throwOnError: true }) : null;
+  return {
+    tabs: (config?.extraRunFrameTabs ?? []).map((tab) => ({
+      tab_name: tab.tabName,
+      iframe_url: tab.iframeUrl,
+      ...tab.mainComponentPath === undefined ? {} : { main_component_path: tab.mainComponentPath }
+    }))
+  };
+}
+
+// lib/site/extra-runframe-tabs-client-script.ts
+var extraRunFrameTabsClientScript = `{
+  let stopped = false;
+  let timeout;
+  let controller;
+  let lifecycleRevision = 0;
+  let previousTabs = JSON.stringify(window.TSCIRCUIT_EXTRA_RUNFRAME_TABS || []);
+  const errorId = "tscircuit-external-tabs-error";
+
+  const refreshExternalTabs = async () => {
+    const revision = lifecycleRevision;
+    const requestController = new AbortController();
+    controller = requestController;
+    const requestTimeout = setTimeout(() => requestController.abort(), 10000);
+    try {
+      const response = await fetch("/api/extra_runframe_tabs/list", {
+        cache: "no-store",
+        signal: requestController.signal
+      });
+      if (!response.ok) throw new Error("External tabs request failed");
+      const payload = await response.json();
+      if (!Array.isArray(payload.tabs)) throw new Error("Invalid external tabs response");
+      const tabs = payload.tabs.map((tab) => ({
+        tabName: tab.tab_name,
+        iframeUrl: tab.iframe_url,
+        ...(tab.main_component_path === undefined ? {} : { mainComponentPath: tab.main_component_path })
+      }));
+      clearTimeout(requestTimeout);
+      if (stopped || revision !== lifecycleRevision) return;
+      const serializedTabs = JSON.stringify(tabs);
+      if (serializedTabs !== previousTabs) {
+        window.TSCIRCUIT_EXTRA_RUNFRAME_TABS = tabs;
+        window.dispatchEvent(new Event("tscircuit:extra-runframe-tabs-change"));
+        previousTabs = serializedTabs;
+      }
+      document.getElementById(errorId)?.remove();
+    } catch (error) {
+      clearTimeout(requestTimeout);
+      if (stopped || revision !== lifecycleRevision) return;
+      if (!document.getElementById(errorId)) {
+        const alert = document.createElement("div");
+        alert.id = errorId;
+        alert.setAttribute("role", "alert");
+        alert.textContent = "External tabs could not update. The displayed pages may be out of date. Check the dev server and project configuration.";
+        alert.style.cssText = "position:fixed;bottom:12px;left:12px;right:12px;z-index:2147483647;padding:12px;background:#7f1d1d;color:white;font:14px sans-serif";
+        document.body.append(alert);
+      }
+    }
+    if (!stopped && revision === lifecycleRevision) timeout = setTimeout(refreshExternalTabs, 1000);
+  };
+
+  window.addEventListener("pagehide", () => {
+    stopped = true;
+    lifecycleRevision++;
+    clearTimeout(timeout);
+    controller?.abort();
+  });
+  window.addEventListener("pageshow", (event) => {
+    if (event.persisted && stopped) {
+      stopped = false;
+      void refreshExternalTabs();
+    }
+  });
+  void refreshExternalTabs();
+}`;
+
 // lib/server/createHttpServer.ts
 var RUNFRAME_CACHE_PATH = "/api/cache";
 var resolveLocalTscircuitStandalonePath = (projectDir) => {
@@ -80881,6 +80990,42 @@ var createHttpServer = async ({
   const server = http.createServer(async (req, res) => {
     const requestHost = req.headers.host ?? `localhost:${port}`;
     const url = new URL(req.url, `http://${requestHost}`);
+    if (url.pathname === "/extra-runframe-tabs.js") {
+      res.writeHead(200, {
+        "Content-Type": "application/javascript; charset=utf-8",
+        "Cache-Control": "no-store"
+      });
+      res.end(extraRunFrameTabsClientScript);
+      return;
+    }
+    if (url.pathname === "/api/extra_runframe_tabs/list") {
+      if (req.method !== "GET" && req.method !== "POST") {
+        res.writeHead(405, { Allow: "GET, POST" });
+        res.end();
+        return;
+      }
+      try {
+        const response = await readExtraRunFrameTabs(projectDir);
+        res.writeHead(200, {
+          "Content-Type": "application/json",
+          "Cache-Control": "no-store"
+        });
+        res.end(JSON.stringify(response));
+      } catch (error) {
+        console.error("Unable to refresh external RunFrame tabs:", error);
+        res.writeHead(500, {
+          "Content-Type": "application/json",
+          "Cache-Control": "no-store"
+        });
+        res.end(JSON.stringify({
+          error: {
+            error_code: "external_tabs_config_invalid",
+            message: "Unable to load external tabs. Check the project configuration."
+          }
+        }));
+      }
+      return;
+    }
     if (preparedJscdnDir && url.pathname.startsWith("/jscdn/")) {
       if (req.method !== "GET" && req.method !== "HEAD") {
         res.writeHead(405, { Allow: "GET, HEAD" });
@@ -81034,10 +81179,22 @@ var createHttpServer = async ({
       return;
     }
     if (url.pathname === "/") {
-      const fileServerApiBaseUrl = `http://${req.headers.host}/api`;
-      const html = await getIndex(defaultMainComponentPath, fileServerApiBaseUrl, preparedJscdnDir ? "/jscdn" : undefined);
-      res.writeHead(200, { "Content-Type": "text/html" });
-      res.end(html);
+      try {
+        const projectConfig = projectDir ? await loadRuntimeProjectConfig(projectDir, { throwOnError: true }) : null;
+        const fileServerApiBaseUrl = `http://${req.headers.host}/api`;
+        const html = await getIndex({
+          mainComponentPath: defaultMainComponentPath,
+          fileServerApiBaseUrl,
+          jscdnBaseUrl: preparedJscdnDir ? "/jscdn" : undefined,
+          extraRunFrameTabs: projectConfig?.extraRunFrameTabs
+        });
+        res.writeHead(200, { "Content-Type": "text/html" });
+        res.end(html);
+      } catch (error) {
+        console.error("Failed to render the RunFrame page:", error);
+        res.writeHead(500, { "Content-Type": "text/plain; charset=utf-8" });
+        res.end("Unable to load project configuration. Check the CLI output and reload.");
+      }
       return;
     }
     if (pcmProxy && url.pathname.startsWith("/pcm")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/cli",
-  "version": "0.1.2383",
+  "version": "0.1.2384",
   "repository": {
     "type": "git",
     "url": "https://github.com/tscircuit/cli"

package/types/tscircuit.config.schema.json

@@ -155,6 +155,33 @@
         }
       },
       "description": "Build output toggles."
+    },
+    "extraRunFrameTabs": {
+      "type": "array",
+      "description": "Additional iframe tabs for tsci dev and build --site. Requires a RunFrame bundle with extra tab support.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["tabName", "iframeUrl"],
+        "properties": {
+          "tabName": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Label displayed in RunFrame."
+          },
+          "iframeUrl": {
+            "type": "string",
+            "format": "uri",
+            "pattern": "^[Hh][Tt][Tt][Pp][Ss]?://",
+            "description": "HTTP or HTTPS iframe URL, including encoded SysConfig content in its fragment."
+          },
+          "mainComponentPath": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional project-relative circuit path. Omit to show this tab for every circuit."
+          }
+        }
+      }
     }
   }
 }