@tscircuit/runframe 0.0.1

package/lib/components/CircuitJsonTableViewer/CircuitJsonTableViewer.tsx

@@ -0,0 +1,315 @@
+import { useReducer, useState } from "react"
+import { ClickableText } from "./ClickableText"
+import { HeaderCell } from "./HeaderCell"
+import Modal from "./Modal"
+
+type Filters = {
+  component_type_filter?:
+    | "any"
+    | "source"
+    | "source/pcb"
+    | "source/schematic"
+    | string
+  id_search?: string
+  name_search?: string
+  selector_search?: string
+  focused_id?: string
+}
+
+type CommonProps = { name?: string; type: string }
+
+type ModalState =
+  | { open: false; element?: never }
+  | { open: true; element: Element; title: string }
+
+interface Element {
+  [key: string]: any
+  type: string
+  name?: string
+}
+
+interface ProcessedElement extends CommonProps {
+  primary_id: string
+  other_ids: { [key: string]: string }
+  selector_path?: string
+  _og_elm: Element
+}
+
+interface Column {
+  key: string
+  name: string
+  renderCell?: (row: ProcessedElement) => React.ReactNode
+  renderHeaderCell?: (col: Column) => React.ReactNode
+}
+
+export const CircuitJsonTableViewer: React.FC<{ elements: Element[] }> = ({
+  elements,
+}) => {
+  const [modal, setModal] = useState<ModalState>({ open: false })
+  const [filters, setFilter] = useReducer(
+    (s: Filters, a: Filters) => ({
+      ...s,
+      ...a,
+    }),
+    {},
+  )
+
+  const element_types = [...new Set(elements.map((e) => e.type))]
+
+  // Process elements to separate primary and non-primary ids
+  const elements2: ProcessedElement[] = elements.map((e) => {
+    const primary_id = e[`${e.type}_id`]
+
+    const other_ids = Object.fromEntries(
+      Object.entries(e).filter(([k]) => {
+        if (k === `${e.type}_id`) return false
+        if (!k.endsWith("_id")) return false
+        return true
+      }),
+    ) as { [key: string]: string }
+
+    const other_props: CommonProps = Object.fromEntries(
+      Object.entries(e).filter(([k]) => !k.endsWith("_id")),
+    ) as CommonProps
+
+    return {
+      primary_id,
+      other_ids,
+      ...other_props,
+      _og_elm: e,
+    }
+  })
+
+  const elements3 = elements2.map((e) => {
+    let selector_path = ""
+
+    const getSelectorPath = (e2: ProcessedElement): string => {
+      const parent_key = Object.keys(e2.other_ids).find((k) =>
+        k.startsWith("source_"),
+      )
+      if (!parent_key) return `.${e2.name}`
+      const parent_type = parent_key.slice(0, -3) // trim "_id"
+
+      const parent = elements2.find(
+        (p) =>
+          p.type === parent_type && p.primary_id === e2.other_ids[parent_key],
+      )
+
+      if (!parent) return `??? > .${e2.name}`
+
+      if (!("name" in parent)) return `#${parent.primary_id} > .${e2.name}`
+
+      return `${getSelectorPath(parent)} > .${e2.name}`
+    }
+
+    if ("name" in e) {
+      selector_path = getSelectorPath(e)
+    }
+
+    return {
+      ...e,
+      selector_path,
+    }
+  })
+
+  const columns: Column[] = [
+    {
+      key: "primary_id",
+      name: "primary_id",
+      renderCell: (row: ProcessedElement) => (
+        <div className="flex items-center">
+          <ClickableText
+            text={row.primary_id}
+            onClick={() =>
+              setFilter({
+                focused_id: row.primary_id,
+                id_search: undefined,
+                selector_search: undefined,
+              })
+            }
+          />
+          <span className="flex-grow" />
+          <ClickableText
+            text="(JSON)"
+            onClick={() =>
+              setModal({
+                open: true,
+                element: row._og_elm,
+                title: row.primary_id,
+              })
+            }
+          />
+        </div>
+      ),
+      renderHeaderCell: (col: Column) => (
+        <HeaderCell
+          column={col}
+          onTextChange={(v) => setFilter({ id_search: v })}
+          field={
+            !filters.focused_id
+              ? undefined
+              : () => (
+                  <div>
+                    Focus:{" "}
+                    <span className="underline">{filters.focused_id}</span>
+                    <ClickableText
+                      text="(unfocus)"
+                      onClick={() => setFilter({ focused_id: undefined })}
+                    />
+                  </div>
+                )
+          }
+        />
+      ),
+    },
+    {
+      key: "type",
+      name: "type",
+      renderHeaderCell: (col: Column) => (
+        <HeaderCell
+          column={col}
+          field={() => (
+            <select
+              onChange={(e) =>
+                setFilter({ component_type_filter: e.target.value })
+              }
+              className="border rounded p-1 w-full"
+            >
+              <option key="any" value="any">
+                any
+              </option>
+              <option key="source" value="source">
+                source
+              </option>
+              <option key="source/pcb" value="source/pcb">
+                source/pcb
+              </option>
+              <option key="source/schematic" value="source/schematic">
+                source/schematic
+              </option>
+              {element_types.map((type) => (
+                <option key={type} value={type}>
+                  {type}
+                </option>
+              ))}
+            </select>
+          )}
+        />
+      ),
+    },
+    {
+      key: "name",
+      name: "name",
+      renderHeaderCell: (col: Column) => (
+        <HeaderCell
+          column={col}
+          onTextChange={(t) => setFilter({ name_search: t })}
+        />
+      ),
+    },
+    {
+      key: "selector_path",
+      name: "selector_path",
+      renderHeaderCell: (col: Column) => (
+        <HeaderCell
+          column={col}
+          onTextChange={(t) => setFilter({ selector_search: t })}
+        />
+      ),
+    },
+    {
+      key: "other_ids",
+      name: "other_ids",
+      renderCell: (row: ProcessedElement) => (
+        <div className="space-x-2">
+          {Object.entries(row.other_ids).map(([other_id, v]) => (
+            <ClickableText
+              key={v}
+              text={v}
+              onClick={() => setFilter({ focused_id: v })}
+            />
+          ))}
+        </div>
+      ),
+    },
+  ]
+
+  const elements4 = elements3
+    .filter((e) => {
+      if (!filters.name_search) return true
+      return e.name?.toLowerCase()?.includes(filters.name_search.toLowerCase())
+    })
+    .filter((e) => {
+      if (!filters.component_type_filter) return true
+      if (filters.component_type_filter === "any") return true
+      if (filters.component_type_filter === "source") {
+        return e.type.startsWith("source_")
+      }
+      if (filters.component_type_filter === "source/pcb") {
+        return e.type.startsWith("source_") || e.type.startsWith("pcb_")
+      }
+      if (filters.component_type_filter === "source/schematic") {
+        return e.type.startsWith("source_") || e.type.startsWith("schematic_")
+      }
+      return e.type?.includes(filters.component_type_filter)
+    })
+    .filter((e) => {
+      if (!filters.selector_search) return true
+      const parts = filters.selector_search
+        .split(" ")
+        .filter((p) => p.length > 0)
+      return parts.every((part) => e.selector_path?.includes(part))
+    })
+    .filter((e) => {
+      if (!filters.id_search) return true
+      return e.primary_id?.includes(filters.id_search)
+    })
+    .filter((e) => {
+      if (!filters.focused_id) return true
+      if (e.primary_id === filters.focused_id) return true
+      if (Object.values(e.other_ids).includes(filters.focused_id)) return true
+      return false
+    })
+
+  return (
+    <div className="font-mono text-xs">
+      <div className="overflow-x-auto">
+        <table className="table-auto w-full text-left">
+          <thead>
+            <tr>
+              {columns.map((col) => (
+                <th key={col.key} className="px-4 py-2 border-b">
+                  {col.renderHeaderCell ? col.renderHeaderCell(col) : col.name}
+                </th>
+              ))}
+            </tr>
+          </thead>
+          <tbody>
+            {elements4.map((row, rowIndex) => (
+              <tr key={rowIndex} className="hover:bg-gray-100">
+                {columns.map((col) => (
+                  <td key={col.key} className="px-4 py-2 border-b">
+                    {col.renderCell
+                      ? col.renderCell(row)
+                      : (row as any)[col.key]}
+                  </td>
+                ))}
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </div>
+      <Modal
+        open={modal.open}
+        onClose={() => setModal({ open: false })}
+        title={modal.open ? modal.title : ""}
+      >
+        <div className="bg-gray-800 p-3 text-white rounded">
+          <pre className="whitespace-pre-wrap">
+            {modal.open ? JSON.stringify(modal.element, null, 2) : ""}
+          </pre>
+        </div>
+      </Modal>
+    </div>
+  )
+}

package/lib/components/CircuitJsonTableViewer/ClickableText.tsx

@@ -0,0 +1,20 @@
+import type React from "react"
+
+interface ClickableTextProps {
+  text: string
+  onClick: () => void
+}
+
+export const ClickableText: React.FC<ClickableTextProps> = ({
+  text,
+  onClick,
+}) => {
+  return (
+    <span
+      className="cursor-pointer underline text-blue-300 mx-2"
+      onClick={onClick}
+    >
+      {text}
+    </span>
+  )
+}

package/lib/components/CircuitJsonTableViewer/HeaderCell.tsx

@@ -0,0 +1,26 @@
+import type React from "react"
+
+interface HeaderCellProps {
+  column: { name: string }
+  field?: () => React.ReactNode
+  onTextChange?: (value: string) => void
+}
+
+export const HeaderCell: React.FC<HeaderCellProps> = (p) => {
+  return (
+    <div className="leading-5">
+      <div className="py-2 font-bold">{p.column.name}</div>
+      <div>
+        {p.field?.() ?? (
+          <input
+            type="text"
+            className="border rounded p-1 w-full"
+            onChange={(e) => {
+              p.onTextChange?.(e.target.value)
+            }}
+          />
+        )}
+      </div>
+    </div>
+  )
+}

package/lib/components/CircuitJsonTableViewer/Modal.tsx

@@ -0,0 +1,38 @@
+import type React from "react"
+
+interface ModalProps {
+  open: boolean
+  children: React.ReactNode
+  title: string
+  onClose: () => void
+}
+
+const Modal: React.FC<ModalProps> = ({ open, children, title, onClose }) => {
+  if (!open) return null
+
+  return (
+    <div
+      className="fixed inset-0 bg-black bg-opacity-50 flex justify-center items-center z-50"
+      onClick={onClose}
+    >
+      <div
+        className="bg-white p-5 rounded-lg relative w-11/12 max-w-2xl"
+        onClick={(e) => {
+          e.preventDefault()
+          e.stopPropagation()
+        }}
+      >
+        <h2 className="mt-0 text-xl">{title}</h2>
+        <button
+          className="absolute top-4 right-4 text-2xl font-bold"
+          onClick={onClose}
+        >
+          &times;
+        </button>
+        {children}
+      </div>
+    </div>
+  )
+}
+
+export default Modal

package/lib/components/ErrorFallback.tsx

@@ -0,0 +1,25 @@
+import React from "react"
+
+export const ErrorFallback = ({ error }: { error: Error }) => {
+  return (
+    <div
+      data-testid="error-container"
+      className="error-container mt-4 bg-red-50 rounded-md border border-red-200"
+    >
+      <div className="p-4">
+        <h2 className="text-lg font-semibold text-red-800 mb-3">
+          Error Loading 3D Viewer
+        </h2>
+        <p className="text-xs font-mono whitespace-pre-wrap text-red-700">
+          {error.message}
+        </p>
+        <details
+          style={{ whiteSpace: "pre-wrap" }}
+          className="text-xs font-mono text-red-600 mt-2"
+        >
+          {error.stack}
+        </details>
+      </div>
+    </div>
+  )
+}

package/lib/components/ErrorTabContent.tsx

@@ -0,0 +1,86 @@
+import { GitHubLogoIcon } from "@radix-ui/react-icons"
+import { ClipboardIcon } from "lucide-react"
+import { Button } from "lib/components/ui/button"
+
+export const ErrorTabContent = ({
+  code,
+  isStreaming,
+  errorMessage,
+}: {
+  code?: string
+  isStreaming?: boolean
+  errorMessage?: string | null
+}) => {
+  if (!errorMessage) {
+    return (
+      <div className="mt-4 bg-green-50 rounded-md border border-green-200">
+        <div className="p-4">
+          <h3 className="text-lg font-semibold text-green-800 mb-3">
+            No Errors 👌
+          </h3>
+          <p className="text-sm text-green-700">
+            Your code is running without any errors.
+          </p>
+        </div>
+      </div>
+    )
+  }
+
+  return (
+    <>
+      <div className="mt-4 bg-red-50 rounded-md border border-red-200 max-h-[500px] overflow-y-auto">
+        <div className="p-4">
+          <h3 className="text-lg font-semibold text-red-800 mb-3">Error</h3>
+          <p className="text-xs font-mono whitespace-pre-wrap text-red-600 mt-2">
+            {errorMessage}
+          </p>
+        </div>
+      </div>
+      <div className="flex gap-2 mt-4 justify-end">
+        <Button
+          variant="outline"
+          onClick={() => {
+            if (!errorMessage) return
+            navigator.clipboard.writeText(errorMessage)
+            alert("Error copied to clipboard!")
+          }}
+        >
+          <ClipboardIcon className="w-4 h-4 mr-2" />
+          Copy Error
+        </Button>
+        <Button
+          variant="outline"
+          onClick={() => {
+            window.alert(
+              "Not supported yet! Please report/upvote an issue on github.com/tscircuit/tscircuit",
+            )
+            // const title = `Error: ${errorMessage
+            //   .replace("Render Error:", "")
+            //   .replace(/\"_errors\":\[\]/g, "")
+            //   .replace(/\{,/g, "{")
+            //   .replace(/"_errors":\[/g, "")
+            //   .replace(/[^a-zA-Z0-9 ]/g, " ")
+            //   .replace(/\s+/g, " ")
+            //   .replace(/ \d+ /g, " ")
+            //   .slice(0, 100)}`
+            // const url = encodeTextToUrlHash(code ?? "").replace(
+            //   "http://localhost:5173",
+            //   "https://snippets.tscircuit.com",
+            // )
+            // let body = `[Snippet code to reproduce](${url})\n\n### Error\n\`\`\`\n${errorMessage.slice(0, 600)}\n\`\`\``
+            // if (body.length > 4000) {
+            //   body = `\`\`\`tsx\n// Please paste the code here\`\`\`\n\n### Error\n\`\`\`\n${errorMessage.slice(0, 2000)}\n\`\`\``
+            // }
+            // window.open(
+            //   `https://github.com/tscircuit/snippets/issues/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}`,
+            //   "_blank",
+            // )
+          }}
+        >
+          <GitHubLogoIcon className="w-4 h-4 mr-2" />
+          Report Issue
+        </Button>
+      </div>
+    </>
+  )
+}

package/lib/components/PcbViewerWithContainerHeight.tsx

@@ -0,0 +1,47 @@
+import { useRef, useState, useLayoutEffect, type ComponentProps } from "react"
+import { PCBViewer } from "@tscircuit/pcb-viewer"
+
+export const PcbViewerWithContainerHeight = ({
+  containerClassName,
+  ...props
+}: {
+  containerClassName?: string
+} & ComponentProps<typeof PCBViewer>) => {
+  const containerRef = useRef<HTMLDivElement>(null)
+  const [computedHeight, setComputedHeight] = useState(620)
+
+  useLayoutEffect(() => {
+    const updateHeight = () => {
+      if (containerRef.current) {
+        const containerHeight = containerRef.current.clientHeight
+        const screenHeight = window.innerHeight
+        setComputedHeight(
+          Math.min(Math.max(containerHeight, 620), screenHeight),
+        )
+      }
+    }
+
+    // Immediate synchronous calculation
+    updateHeight()
+
+    // Resize listener for dynamic changes
+    const resizeObserver = new ResizeObserver(updateHeight)
+    if (containerRef.current) {
+      resizeObserver.observe(containerRef.current)
+    }
+
+    // Fallback for window resize
+    window.addEventListener("resize", updateHeight)
+
+    return () => {
+      resizeObserver.disconnect()
+      window.removeEventListener("resize", updateHeight)
+    }
+  }, [])
+
+  return (
+    <div ref={containerRef} className={containerClassName || "w-full h-full"}>
+      <PCBViewer {...props} height={computedHeight} />
+    </div>
+  )
+}

package/lib/components/PreviewEmptyState.tsx

@@ -0,0 +1,14 @@
+import { Button } from "lib/components/ui/button"
+import { PlayIcon } from "lucide-react"
+
+const PreviewEmptyState = ({ onRunClicked }: { onRunClicked: () => void }) => (
+  <div className="flex items-center gap-3 bg-gray-100 text-center justify-center py-10">
+    No circuit json loaded
+    <Button className="bg-blue-600 hover:bg-blue-500" onClick={onRunClicked}>
+      Run Code
+      <PlayIcon className="w-3 h-3 ml-2" />
+    </Button>
+  </div>
+)
+
+export default PreviewEmptyState

package/lib/components/RunFrame.tsx

@@ -0,0 +1,68 @@
+import { createCircuitWebWorker } from "@tscircuit/eval-webworker"
+import { CircuitJsonPreview } from "./CircuitJsonPreview"
+import { useEffect, useState } from "react"
+
+// @ts-ignore
+import evalWebWorkerBlobUrl from "@tscircuit/eval-webworker/blob-url"
+
+interface Props {
+  /**
+   * Map of filenames to file contents that will be available in the worker
+   */
+  fsMap: { [filename: string]: string }
+
+  /**
+   * The entry point file that will be executed first
+   */
+  entrypoint: string
+
+  /**
+   * Called when the circuit JSON changes
+   */
+  onCircuitJsonChange?: (circuitJson: any) => void
+
+  /**
+   * Called when rendering is finished
+   */
+  onRenderingFinished?: (params: { circuitJson: any }) => void
+
+  /**
+   * Called for each render event
+   */
+  onRenderEvent?: (event: any) => void
+
+  /**
+   * Called when an error occurs
+   */
+  onError?: (error: Error) => void
+}
+
+export const RunFrame = (props: Props) => {
+  const [circuitJson, setCircuitJson] = useState<any>(null)
+
+  useEffect(() => {
+    async function runWorker() {
+      const worker = await createCircuitWebWorker({
+        webWorkerUrl: evalWebWorkerBlobUrl,
+        verbose: true,
+      })
+      const $finished = worker.executeWithFsMap({
+        entrypoint: props.entrypoint,
+        fsMap: props.fsMap,
+      })
+      console.log("waiting for execution to finish...")
+      await $finished
+      console.log("waiting for initial circuit json...")
+      setCircuitJson(await worker.getCircuitJson())
+      console.log("got initial circuit json")
+      await $finished.catch((e) => {
+        console.error(e)
+      })
+      setCircuitJson(await worker.getCircuitJson())
+    }
+    runWorker()
+  }, [props.fsMap])
+
+  console.log({ circuitJson })
+  return <CircuitJsonPreview circuitJson={circuitJson} />
+}

package/lib/components/RunFrameWithApi/index.tsx

@@ -0,0 +1,41 @@
+import { useEffect } from "react"
+import { RunFrame } from "../RunFrame"
+import { useRunFrameStore, selectCurrentFileMap } from "./store"
+import type { RunFrameWithApiProps } from "./types"
+
+const guessEntrypoint = (files: string[]) =>
+  files.find((file) => file.endsWith(".tsx"))
+
+export const RunFrameWithApi = ({ apiBaseUrl }: RunFrameWithApiProps) => {
+  const { startPolling, stopPolling } = useRunFrameStore()
+  const fsMap = useRunFrameStore(selectCurrentFileMap)
+
+  // Initialize API base URL
+  useEffect(() => {
+    if (apiBaseUrl) {
+      window.API_BASE_URL = apiBaseUrl
+    }
+  }, [apiBaseUrl])
+
+  // Start/stop polling
+  useEffect(() => {
+    startPolling()
+    return () => stopPolling()
+  }, [startPolling, stopPolling])
+
+  const entrypoint = guessEntrypoint(Object.keys(fsMap))
+
+  if (!entrypoint) {
+    return <div>No entrypoint found for Run Frame!</div>
+  }
+
+  return (
+    <RunFrame
+      fsMap={fsMap}
+      entrypoint={entrypoint}
+      onError={(error) => {
+        console.error("RunFrame error:", error)
+      }}
+    />
+  )
+}

package/lib/components/RunFrameWithApi/standalone.tsx

@@ -0,0 +1,6 @@
+import { createRoot } from "react-dom/client"
+import { RunFrameWithApi } from "./index"
+
+const root = createRoot(document.getElementById("root")!)
+
+root.render(<RunFrameWithApi />)