Add option to build with tsgo

tsgo will crash without microsoft/typescript-go#2264

Additional tweaks are required for typescript language changes.

There are additional semantic errors (I assume bugs) that affect the tsgo CLI but not language server that also need further investigation.

Author: lauckhart

package-lock.json

@@ -63,17 +63,18 @@
         "commander": "^14.0.2",
         "esbuild": "^0.27.0",
         "minimatch": "^10.1.1",
-        "typescript": "~5.9.3",
         "type-fest": "^5.2.0",
         "typedoc": "^0.28.15",
-        "typedoc-github-theme": "^0.3.1"
+        "typedoc-github-theme": "^0.3.1",
+        "typescript": "~5.9.3"
     },
     "optionalDependencies": {
         "@esbuild/linux-x64": "^0.27.0"
     },
     "devDependencies": {
         "@types/madge": "^5.0.3",
         "@types/node": "^24.10.1",
+        "@typescript/native-preview": "^7.0.0-dev.20251205.1",
         "detective-typescript": "^14.0.0"
     },
     "publishConfig": {

packages/tools/package.json

@@ -37,7 +37,8 @@ export async function main(argv = process.argv) {
     const program = commander("matter-build", "Builds packages adhering to matter.js standards.")
         .option("-p, --prefix <path>", "specify build directory", ".")
         .option("-c, --clean", "clean before build", false)
-        .option("-d, --dependencies", "build dependencies", false);
+        .option("-d, --dependencies", "build dependencies", false)
+        .option("--tsgo", "use experimental TS 7 compiler", false);
 
     program
         .command("build")

packages/tools/src/building/cli.ts

@@ -11,16 +11,16 @@ export class InternalBuildError extends Error {
 }
 
 export class BuildError extends Error {
-    constructor(readonly diagnostics: string) {
+    constructor(readonly diagnostics?: string) {
         super();
     }
 
     override get stack() {
-        return this.diagnostics;
+        return this.diagnostics ?? super.stack;
     }
 
     override toString() {
-        return this.diagnostics;
+        return this.diagnostics ?? "Build error";
     }
 
     inspect() {

packages/tools/src/building/error.ts

@@ -9,7 +9,7 @@ import { Progress } from "../util/progress.js";
 import { BuildError } from "./error.js";
 import { Graph } from "./graph.js";
 import { BuildInformation, Project } from "./project.js";
-import { createTypescriptContext } from "./typescript.js";
+import { createTsgoContext, createTypescriptContext } from "./typescript.js";
 import { TypescriptContext } from "./typescript/context.js";
 
 export enum Target {
@@ -23,6 +23,7 @@ export interface Options {
     targets?: Target[];
     clean?: boolean;
     graph?: Graph;
+    tsgo?: boolean;
 }
 
 /**
@@ -34,11 +35,13 @@ export class ProjectBuilder {
     unconditional: boolean;
     tsContext?: TypescriptContext;
     graph?: Graph;
+    tsgo?: boolean;
 
     constructor(private options: Options = {}) {
         this.graph = options.graph;
         this.unconditional =
             options.clean || (options.targets !== undefined && options.targets?.indexOf(Target.clean) !== -1);
+        this.tsgo = options.tsgo;
     }
 
     get hasClean() {
@@ -112,7 +115,12 @@ export class ProjectBuilder {
                 // Obtain or initialize typescript solution builder
                 let context = this.tsContext;
                 if (context === undefined) {
-                    context = this.tsContext = await createTypescriptContext(project.pkg.workspace, graph);
+                    if (this.tsgo) {
+                        context = createTsgoContext(project.pkg.workspace);
+                    } else {
+                        context = await createTypescriptContext(project.pkg.workspace, graph);
+                    }
+                    this.tsContext = context;
                 }
 
                 const refreshCallback = progress.refresh.bind(progress);
@@ -152,8 +160,10 @@ export class ProjectBuilder {
                 }
             } catch (e) {
                 if (e instanceof BuildError) {
+                    if (e.diagnostics) {
+                        process.stderr.write(`${e.diagnostics}\n`);
+                    }
                     progress.failure("Terminating due to type errors");
-                    process.stderr.write(`${e.diagnostics}\n`);
                     process.exit(1);
                 }
                 throw e;

packages/tools/src/building/project-builder.ts

@@ -6,6 +6,7 @@
 
 import { type TypescriptContext } from "./typescript/context.js";
 import { createSolutionBuilderContext } from "./typescript/solution-builder.js";
+export { createTsgoContext } from "./typescript/tsgo.js";
 
 /**
  * Create a {@link TypescriptContext} for validating types and optionally emitting .d.ts file.

packages/tools/src/building/typescript.ts

@@ -39,7 +39,7 @@ export async function createSolutionBuilderContext(
 
     function currentContext() {
         if (context === undefined) {
-            throw new Error("Build context accessed with no ");
+            throw new Error("Build context accessed with no context");
         }
         return context;
     }

packages/tools/src/building/typescript/solution-builder.ts

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { spawn } from "node:child_process";
+import { cp } from "node:fs/promises";
+import { join } from "path";
+import { isDirectory } from "../../util/file.js";
+import { Package } from "../../util/package.js";
+import { BuildError } from "../error.js";
+import { TypescriptContext } from "./context.js";
+
+export function createTsgoContext(workspace: Package): TypescriptContext {
+    const bin = join(workspace.resolve("node_modules", ".bin", "tsgo"));
+    return {
+        async build(pkg, path, _refreshCallback, emit) {
+            const args = ["--project", path];
+
+            if (emit === false) {
+                args.push("--noEmit");
+            }
+
+            await new Promise<void>((resolve, reject) => {
+                const tsgo = spawn(bin, args, { stdio: "inherit" });
+
+                tsgo.on("exit", (code, signal) => {
+                    switch (code) {
+                        case 0:
+                            resolve();
+                            break;
+
+                        case 1: // Diagnostics present, outputs generated
+                        case 2: // Diagnostics present, outputs skipped
+                        case 3: // Project invalid
+                        case 4: // Reference cycle
+                        case 5: // Not implemented
+                            // TS will have printed an error already
+                            reject(new BuildError());
+                            break;
+
+                        case null:
+                            reject(new BuildError(`tsgo exited with signal ${signal}`));
+                            break;
+
+                        default:
+                            reject(new BuildError(`tsgo exited with code ${code}`));
+                            break;
+                    }
+                });
+            });
+
+            await cp(pkg.resolve("dist/esm"), pkg.resolve("dist/cjs"), {
+                recursive: true,
+                filter(src) {
+                    if (isDirectory(src)) {
+                        return true;
+                    }
+
+                    return src.endsWith(".d.ts") || src.endsWith(".d.ts.map");
+                },
+            });
+        },
+    };
+}