ci: batch-typecheck examples with tsgo; lighten pre-commit

Replaces 23 per-example `tsc --noEmit` invocations with a single
`tsgo -b --noEmit` batch call that checks all 46 tsconfigs (SDK +
example client + server configs) in one process.

Local (14-core): typecheck 46 configs in ~2s (was ~50s CPU across
separate tsc spawns). examples:build: 22s → 15.5s wall, 148s → 82s CPU.

CI: expect examples:build ~135s → ~80-90s on Linux (2-core runners
were bottlenecked on tsc spawn overhead + contention). Also skips the
redundant SDK rebuild inside preexamples:build.

Pre-commit: replaces full build:all (all vite bundles) with SDK build
+ typecheck. CI still does the full build.

tsgo pinned to 7.0.0-dev.20260305.1. Used for --noEmit only; .d.ts
emission stays on tsc (tsgo declaration emit has known nondeterminism,
microsoft/typescript-go#1570).

Side fix: 14 examples imported CSS without vite-env.d.ts. tsc 5.9
tolerates this but tsgo enforces TS2882. Added the standard Vite shim.

Author: ochafik

.github/workflows/ci.yml

@@ -83,7 +83,13 @@ jobs:
         if: runner.os == 'Linux' && matrix.name == 'Linux x64'
         run: npm exec typedoc -- --treatValidationWarningsAsErrors --emit none
 
-      - run: npm run examples:build
+      # Fast-fail typecheck of SDK + all examples (~46 tsconfigs) in one tsgo process.
+      # Replaces the per-example `tsc --noEmit` that used to run inside examples:build.
+      - run: npm run typecheck
+
+      # examples:build runs `npm run build` again via preexamples:build — skip that
+      # since we already built the SDK above. Call the runner directly.
+      - run: npx bun examples/run-all.ts build
 
       - name: Verify generated schemas are up-to-date
         shell: bash
@@ -162,7 +168,8 @@ jobs:
         run: |
           npm ci
           npm run build
-          npm run examples:build
+          npm run typecheck
+          npx bun examples/run-all.ts build
           npm test
           npm run prettier
 

.gitignore

@@ -7,6 +7,7 @@ bun.lockb
 docs/api/
 tmp/
 intermediate-findings/
+*.tsbuildinfo
 
 # Playwright
 playwright-report/

.husky/pre-commit

@@ -18,7 +18,11 @@ fi
 # (avoids sweeping unrelated WIP into the commit)
 STAGED=$(git diff --name-only --cached)
 
-npm run build:all
+# Build SDK only (regenerates src/generated/, emits dist/ needed by example typecheck)
+npm run build
+# Fast batch typecheck of SDK + all examples via tsgo (~2s). Replaces the full
+# examples:build bundle step — CI still does the full build.
+npm run typecheck
 npm run prettier:fix
 
 # Re-stage originally-staged files (prettier may have reformatted them)

examples/basic-host/package.json

@@ -4,7 +4,7 @@
   "version": "1.2.0",
   "type": "module",
   "scripts": {
-    "build": "tsc --noEmit && concurrently \"cross-env INPUT=index.html vite build\" \"cross-env INPUT=sandbox.html vite build\"",
+    "build": "concurrently \"cross-env INPUT=index.html vite build\" \"cross-env INPUT=sandbox.html vite build\"",
     "watch": "concurrently \"cross-env INPUT=index.html vite build --watch\" \"cross-env INPUT=sandbox.html vite build --watch\"",
     "serve": "bun --watch serve.ts",
     "start": "cross-env NODE_ENV=development npm run build && npm run serve",

examples/basic-server-preact/package.json

@@ -14,7 +14,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc --noEmit && cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
+    "build": "cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
     "watch": "cross-env INPUT=mcp-app.html vite build --watch",
     "serve": "bun --watch main.ts",
     "serve:stdio": "bun main.ts --stdio",

examples/basic-server-react/package.json

@@ -24,7 +24,7 @@
     }
   },
   "scripts": {
-    "build": "tsc --noEmit && cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
+    "build": "cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
     "watch": "cross-env INPUT=mcp-app.html vite build --watch",
     "serve": "bun --watch main.ts",
     "serve:stdio": "bun main.ts --stdio",

examples/basic-server-solid/package.json

@@ -14,7 +14,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc --noEmit && cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
+    "build": "cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
     "watch": "cross-env INPUT=mcp-app.html vite build --watch",
     "serve": "bun --watch main.ts",
     "serve:stdio": "bun main.ts --stdio",

examples/basic-server-svelte/package.json

@@ -14,7 +14,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc --noEmit && cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
+    "build": "cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
     "watch": "cross-env INPUT=mcp-app.html vite build --watch",
     "serve": "bun --watch main.ts",
     "serve:stdio": "bun main.ts --stdio",

examples/basic-server-svelte/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

examples/basic-server-vanillajs/package.json

@@ -14,7 +14,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc --noEmit && cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
+    "build": "cross-env INPUT=mcp-app.html vite build && tsc -p tsconfig.server.json && bun build server.ts --outdir dist --target node && bun build main.ts --outfile dist/index.js --target node --external \"./server.js\" --banner \"#!/usr/bin/env node\"",
     "watch": "cross-env INPUT=mcp-app.html vite build --watch",
     "serve": "bun --watch main.ts",
     "serve:stdio": "bun main.ts --stdio",