@tscircuit/runframe 0.0.952 → 0.0.954

package/dist/{chunk-DZRMQXIQ.js → chunk-NPF4TT4U.js}

@@ -1426,7 +1426,7 @@ var useErrorTelemetry = ({
 };
 
 // package.json
-var version = "0.0.951";
+var version = "0.0.953";
 
 // lib/hooks/use-eval-versions.ts
 import { useEffect as useEffect5, useMemo as useMemo2, useState as useState6 } from "react";

package/dist/preview.js

@@ -8,7 +8,7 @@ import {
   linkify,
   useOrderDialog,
   useOrderDialogCli
-} from "./chunk-DZRMQXIQ.js";
+} from "./chunk-NPF4TT4U.js";
 export {
   BomTable,
   CadViewer,

package/dist/runner.d.ts

@@ -148,6 +148,14 @@ interface RunFrameWithApiProps {
      * Enable fetch proxy for the web worker (useful for standalone bundles)
      */
     enableFetchProxy?: boolean;
+    /**
+     * The main component path that should be selected initially when available.
+     */
+    initialMainComponentPath?: string;
+    /**
+     * Callback invoked whenever the selected main component path changes.
+     */
+    onMainComponentPathChange?: (path: string) => void;
 }
 declare const RunFrameWithApi: (props: RunFrameWithApiProps) => react_jsx_runtime.JSX.Element;
 

package/dist/runner.js

@@ -23,7 +23,7 @@ import {
   useRunFrameStore,
   useRunnerStore,
   useStyles
-} from "./chunk-DZRMQXIQ.js";
+} from "./chunk-NPF4TT4U.js";
 
 // lib/components/RunFrame/RunFrame.tsx
 import { createCircuitWebWorker } from "@tscircuit/eval/worker";
@@ -905,7 +905,9 @@ var RunFrameWithApi = (props) => {
   );
   const fsMap = useRunFrameStore((s) => s.fsMap);
   const circuitJson = useRunFrameStore((s) => s.circuitJson);
-  const [componentPath, setComponentPath] = useState4("");
+  const [componentPath, setComponentPath] = useState4(
+    props.initialMainComponentPath ?? ""
+  );
   const [isLoadingFiles, setIsLoadingFiles] = useState4(true);
   useEffect5(() => {
     setIsLoadingFiles(true);
@@ -917,17 +919,26 @@ var RunFrameWithApi = (props) => {
       return;
     }
     const defaultPath = window?.TSCIRCUIT_DEFAULT_MAIN_COMPONENT_PATH;
-    if (defaultPath && files.includes(defaultPath)) {
-      setComponentPath(defaultPath);
-    } else {
-      const firstMatch = files.find(
-        (file) => (file.endsWith(".tsx") || file.endsWith(".ts") || file.endsWith(".jsx") || file.endsWith(".js")) && !file.endsWith(".d.ts")
-      );
-      if (firstMatch) {
-        setComponentPath(firstMatch);
+    const candidatePaths = [props.initialMainComponentPath, defaultPath].filter(
+      (value) => Boolean(value)
+    );
+    for (const candidate of candidatePaths) {
+      if (files.includes(candidate)) {
+        setComponentPath(candidate);
+        return;
       }
     }
-  }, [fsMap]);
+    const firstMatch = files.find(
+      (file) => (file.endsWith(".tsx") || file.endsWith(".ts") || file.endsWith(".jsx") || file.endsWith(".js")) && !file.endsWith(".d.ts")
+    );
+    if (firstMatch) {
+      setComponentPath(firstMatch);
+    }
+  }, [fsMap, props.initialMainComponentPath, componentPath]);
+  useEffect5(() => {
+    if (!componentPath) return;
+    props.onMainComponentPathChange?.(componentPath);
+  }, [componentPath, props.onMainComponentPathChange]);
   useSyncPageTitle();
   const {
     editEventsForRender,
@@ -1022,12 +1033,27 @@ var RunFrameWithApi = (props) => {
 };
 
 // lib/components/RunFrameForCli/RunFrameForCli.tsx
+import { useCallback as useCallback3, useState as useState5 } from "react";
 import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
 var RunFrameForCli = (props) => {
   const [shouldLoadLatestEval, setLoadLatestEval] = useLocalStorageState(
     "load-latest-eval",
     true
   );
+  const [initialMainComponentPath] = useState5(() => {
+    if (typeof window === "undefined") return void 0;
+    const params = new URLSearchParams(window.location.hash.slice(1));
+    return params.get("main_component") ?? void 0;
+  });
+  const updateMainComponentHash = useCallback3((mainComponentPath) => {
+    if (typeof window === "undefined") return;
+    const params = new URLSearchParams(window.location.hash.slice(1));
+    if (params.get("main_component") === mainComponentPath) return;
+    params.set("main_component", mainComponentPath);
+    const newHash = params.toString();
+    const newUrl = `${window.location.pathname}${window.location.search}` + (newHash.length > 0 ? `#${newHash}` : "");
+    window.history.replaceState(null, "", newUrl);
+  }, []);
   return /* @__PURE__ */ jsx6(
     RunFrameWithApi,
     {
@@ -1039,6 +1065,8 @@ var RunFrameForCli = (props) => {
       showFilesSwitch: true,
       showFileMenu: false,
       enableFetchProxy: props.enableFetchProxy,
+      initialMainComponentPath,
+      onMainComponentPathChange: updateMainComponentHash,
       leftHeaderContent: /* @__PURE__ */ jsxs5("div", { className: "rf-flex rf-items-center rf-justify-between", children: [
         /* @__PURE__ */ jsx6(
           FileMenuLeftHeader,