@tscircuit/cli 0.1.4 → 0.1.6

package/lib/dependency-analysis/{installNodeModuleTypes.ts → installNodeModuleTypesForSnippet.ts}

@@ -8,7 +8,7 @@ interface SnippetApiResponse {
   }
 }
 
-export async function installTypes(snippetPath: string) {
+export async function installNodeModuleTypesForSnippet(snippetPath: string) {
   const content = fs.readFileSync(snippetPath, "utf-8")
   const sourceFile = ts.createSourceFile(
     snippetPath,

package/lib/file-server/FileServerEvent.ts

@@ -0,0 +1,7 @@
+export interface FileUpdatedEvent {
+  event_id: string
+  event_type: "FILE_UPDATED"
+  file_path: string
+  initiator?: "filesystem_change" | "browser_edit"
+  created_at: string
+}

package/lib/file-server/FileServerRoutes.ts

@@ -0,0 +1,38 @@
+export interface FileServerRoutes {
+  "api/files/get": {
+    GET: {
+      searchParams: {
+        file_path: string
+      }
+      responseJson: {
+        file: {
+          file_id: string
+          file_path: string
+          text_content: string
+        }
+      }
+    }
+  }
+  "api/files/upsert": {
+    POST: {
+      requestJson: {
+        file_path: string
+        text_content: string
+        initiator?: "filesystem_change"
+      }
+      responseJson: {
+        file: {
+          file_id: string
+          file_path: string
+        }
+      }
+    }
+  }
+  "api/files/list": {
+    GET: {
+      responseJson: {
+        file_list: { file_id: string; file_path: string }[]
+      }
+    }
+  }
+}

package/lib/index.ts

@@ -1,2 +1,2 @@
-export { createServer } from "./server/createServer"
+export { createHttpServer } from "./server/createHttpServer"
 export { getLocalFileDependencies } from "./dependency-analysis/getLocalFileDependencies"

package/lib/server/{createServer.ts → createHttpServer.ts}

@@ -8,7 +8,7 @@ import pkg from "../../package.json"
 import winterspecBundle from "@tscircuit/file-server/dist/bundle.js"
 import { getIndex } from "../site/getIndex"
 
-export const createServer = async (port: number = 3000) => {
+export const createHttpServer = async (port = 3000) => {
   const fileServerHandler = getNodeHandler(winterspecBundle as any, {})
 
   const server = http.createServer(async (req, res) => {
@@ -58,10 +58,10 @@ export const createServer = async (port: number = 3000) => {
     res.end("Not found")
   })
 
-  return new Promise<void>((resolve) => {
+  return new Promise<{ server: http.Server }>((resolve) => {
     server.listen(port, () => {
       console.log(`Server running at http://localhost:${port}`)
-      resolve()
+      resolve({ server })
     })
   })
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@tscircuit/cli",
   "main": "dist/main.js",
   "type": "module",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "bin": {
     "tsci": "./dist/main.js"
   },
@@ -17,16 +17,20 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@tscircuit/core": "^0.0.249",
-    "@types/bun": "latest",
+    "@types/bun": "^1.1.15",
     "@types/configstore": "^6.0.2",
     "@types/react": "^19.0.1",
-    "tsup": "^8.3.5"
+    "@types/semver": "^7.5.8",
+    "get-port": "^7.1.0",
+    "tempy": "^3.1.0",
+    "tsup": "^8.3.5",
+    "typed-ky": "^0.0.4"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "@tscircuit/file-server": "^0.0.11",
+    "@tscircuit/file-server": "^0.0.13",
     "@tscircuit/runframe": "^0.0.47",
     "chokidar": "^4.0.1",
     "commander": "^12.1.0",
@@ -34,6 +38,7 @@
     "cosmiconfig": "^9.0.0",
     "delay": "^6.0.0",
     "ky": "^1.7.4",
-    "perfect-cli": "^1.0.20"
+    "perfect-cli": "^1.0.20",
+    "semver": "^7.6.3"
   }
 }

package/tests/fixtures/get-test-fixture.ts

@@ -0,0 +1,25 @@
+import * as tempy from "tempy"
+import getPort from "get-port"
+
+interface Params {
+  vfs?: Record<string, string>
+}
+
+export const getTestFixture = async (params: Params) => {
+  // Create temp directory
+  const tempDirPath = await tempy.temporaryDirectory()
+  const devServerPort = await getPort()
+
+  // Write virtual filesystem files
+  if (params.vfs) {
+    for (const [filePath, content] of Object.entries(params.vfs)) {
+      await Bun.write(`${tempDirPath}/${filePath}`, content)
+    }
+  }
+
+  return {
+    tempDirPath,
+    devServerPort,
+    devServerUrl: `http://localhost:${devServerPort}`,
+  }
+}

package/tests/test1-dev-server-basic.test.ts

@@ -0,0 +1,40 @@
+import { test, expect, afterEach } from "bun:test"
+import { DevServer } from "cli/dev/DevServer"
+import { getTestFixture } from "tests/fixtures/get-test-fixture"
+
+test("test1 basic dev server filesystem watching", async () => {
+  const { tempDirPath, devServerPort, devServerUrl } = await getTestFixture({
+    vfs: {
+      "snippet.tsx": `
+      export const MyCircuit = () => (
+        <board width="10mm" height="10mm">
+          <chip name="U1" footprint="soic8" />
+        </board>
+      )
+      `,
+      "manual-edits.json": "{}",
+    },
+  })
+
+  const devServer = new DevServer({
+    port: devServerPort,
+    componentFilePath: `${tempDirPath}/snippet.tsx`,
+  })
+
+  await devServer.start()
+  await devServer.addEntrypoint()
+
+  const { file_list } = await devServer.fsKy.get("api/files/list").json()
+
+  expect(file_list.map((f) => f.file_path).sort()).toMatchInlineSnapshot(`
+[
+  "entrypoint.tsx",
+  "manual-edits.json",
+  "snippet.tsx",
+]
+`)
+
+  afterEach(async () => {
+    await devServer.stop()
+  })
+})

package/tsconfig.json

@@ -10,7 +10,8 @@
     "baseUrl": ".",
     "paths": {
       "lib/*": ["lib/*"],
-      "cli/*": ["cli/*"]
+      "cli/*": ["cli/*"],
+      "tests/*": ["tests/*"]
     },
 
     // Bundler mode