ttsc 0.14.2 → 0.15.1

package/shim/compiler/emitassemble.go

@@ -0,0 +1,30 @@
+// gen_shims:hand-maintained
+//
+// Emit-pipeline assembly parts: pick the files tsgo would emit and resolve
+// their output paths, so ttsc's driver can drive emit per file with a plugin
+// transformer inserted ahead of the builtin chain.
+package compiler
+
+import (
+  _ "unsafe"
+
+  innerast "github.com/microsoft/typescript-go/internal/ast"
+  innercompiler "github.com/microsoft/typescript-go/internal/compiler"
+  innercore "github.com/microsoft/typescript-go/internal/core"
+  inneroutputpaths "github.com/microsoft/typescript-go/internal/outputpaths"
+)
+
+// GetSourceFilesToEmit returns the source files tsgo would emit for the program
+// (excludes .d.ts and external-library files), linked from the internal package.
+//
+//go:linkname GetSourceFilesToEmit github.com/microsoft/typescript-go/internal/compiler.getSourceFilesToEmit
+func GetSourceFilesToEmit(host innercompiler.SourceFileMayBeEmittedHost, targetSourceFile *innerast.SourceFile, forceDtsEmit bool) []*innerast.SourceFile
+
+// OutputPaths holds the resolved output file paths for one source file.
+type OutputPaths = inneroutputpaths.OutputPaths
+
+// GetOutputPathsFor resolves the .js / .d.ts / map output paths for a source
+// file (honoring rootDir/outDir), the same call tsgo's emitter makes.
+func GetOutputPathsFor(sourceFile *innerast.SourceFile, options *innercore.CompilerOptions, host inneroutputpaths.OutputPathsHost, forceDtsEmit bool) *inneroutputpaths.OutputPaths {
+  return inneroutputpaths.GetOutputPathsFor(sourceFile, options, host, forceDtsEmit)
+}

package/shim/compiler/emithook.go

@@ -0,0 +1,22 @@
+// gen_shims:hand-maintained
+//
+// Exposes tsgo's emit-stage internals so ttsc can assemble the emit pipeline
+// from real tsgo parts (no tsgo source copy/edit): obtain the builtin
+// transformer chain for a file and prepend a plugin transformer that shares the
+// same EmitContext, so module-transform aliases plugin-generated imports.
+package compiler
+
+import (
+  _ "unsafe"
+
+  innerast "github.com/microsoft/typescript-go/internal/ast"
+  innerprinter "github.com/microsoft/typescript-go/internal/printer"
+  innertransformers "github.com/microsoft/typescript-go/internal/transformers"
+)
+
+// GetScriptTransformers returns tsgo's builtin emit transformer chain
+// (type-erase, import-elision, runtime-syntax, module-transform, ...) for one
+// source file, linked from the internal package via go:linkname.
+//
+//go:linkname GetScriptTransformers github.com/microsoft/typescript-go/internal/compiler.getScriptTransformers
+func GetScriptTransformers(emitContext *innerprinter.EmitContext, host innerprinter.EmitHost, sourceFile *innerast.SourceFile) []*innertransformers.Transformer

package/shim/compiler/go.mod

@@ -3,3 +3,12 @@ module github.com/microsoft/typescript-go/shim/compiler
 go 1.26
 
 require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+
+require (
+	github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/zeebo/xxh3 v1.1.0 // indirect
+	golang.org/x/sync v0.20.0 // indirect
+	golang.org/x/sys v0.43.0 // indirect
+	golang.org/x/text v0.36.0 // indirect
+)

package/shim/compiler/go.sum

@@ -0,0 +1,22 @@
+github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 h1:vymEbVwYFP/L05h5TKQxvkXoKxNvTpjxYKdF1Nlwuao=
+github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
+github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157 h1:llOMPhKDiQ+UEJiAaQuuWaJOTg5V7tNNTEf9JPWoYSY=
+github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157/go.mod h1:m8YA0PMC7ti0GW0RI05D6fEcjQeu98XVS+FWF+VDW2k=
+github.com/peter-evans/patience v0.3.0 h1:rX0JdJeepqdQl1Sk9c9uvorjYYzL2TfgLX1adqYm9cA=
+github.com/peter-evans/patience v0.3.0/go.mod h1:Kmxu5sY1NmBLFSStvXjX1wS9mIv7wMcP/ubucyMOAu0=
+github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
+github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
+github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
+github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
+golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4=
+golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.43.0 h1:Rlag2XtaFTxp19wS8MXlJwTvoh8ArU6ezoyFsMyCTNI=
+golang.org/x/sys v0.43.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.36.0 h1:JfKh3XmcRPqZPKevfXVpI1wXPTqbkE5f7JA92a55Yxg=
+golang.org/x/text v0.36.0/go.mod h1:NIdBknypM8iqVmPiuco0Dh6P5Jcdk8lJL0CUebqK164=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/shim/core/modulekind.go

@@ -0,0 +1,10 @@
+// gen_shims:hand-maintained
+//
+// Re-exports the ModuleKind enum so plugins / ttsc can type emit-format values
+// (e.g. an EmitHost.GetEmitModuleFormatOfFile result).
+package core
+
+import innercore "github.com/microsoft/typescript-go/internal/core"
+
+// ModuleKind is tsgo's module-format enum (CommonJS, ESNext, NodeNext, ...).
+type ModuleKind = innercore.ModuleKind

package/shim/printer/emithost.go

@@ -0,0 +1,24 @@
+// gen_shims:hand-maintained
+//
+// Re-exports the emit host/resolver interfaces so ttsc's driver can implement
+// its own EmitHost (delegating to driver.Program) and hand it to
+// compiler.GetScriptTransformers when assembling the emit pipeline.
+package printer
+
+import innerprinter "github.com/microsoft/typescript-go/internal/printer"
+
+// EmitHost is the per-emit host interface tsgo's transformers query (Options,
+// SourceFiles, GetEmitResolver, GetEmitModuleFormatOfFile, WriteFile, ...).
+type EmitHost = innerprinter.EmitHost
+
+// EmitResolver resolves emit-time facts about nodes (referenced imports,
+// declaration flags, ...) under the checker mutex.
+type EmitResolver = innerprinter.EmitResolver
+
+// EmitTextWriter is the sink the printer emits into; String() yields the text.
+type EmitTextWriter = innerprinter.EmitTextWriter
+
+// NewTextWriter creates a fresh writer for one emit (newLine e.g. "\n").
+func NewTextWriter(newLine string, indentSize int) EmitTextWriter {
+  return innerprinter.NewTextWriter(newLine, indentSize)
+}

package/shim/printer/go.mod

@@ -3,3 +3,12 @@ module github.com/microsoft/typescript-go/shim/printer
 go 1.26
 
 require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+
+require (
+	github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/zeebo/xxh3 v1.1.0 // indirect
+	golang.org/x/sync v0.20.0 // indirect
+	golang.org/x/sys v0.43.0 // indirect
+	golang.org/x/text v0.36.0 // indirect
+)

package/shim/printer/go.sum

@@ -0,0 +1,22 @@
+github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 h1:vymEbVwYFP/L05h5TKQxvkXoKxNvTpjxYKdF1Nlwuao=
+github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
+github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157 h1:llOMPhKDiQ+UEJiAaQuuWaJOTg5V7tNNTEf9JPWoYSY=
+github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157/go.mod h1:m8YA0PMC7ti0GW0RI05D6fEcjQeu98XVS+FWF+VDW2k=
+github.com/peter-evans/patience v0.3.0 h1:rX0JdJeepqdQl1Sk9c9uvorjYYzL2TfgLX1adqYm9cA=
+github.com/peter-evans/patience v0.3.0/go.mod h1:Kmxu5sY1NmBLFSStvXjX1wS9mIv7wMcP/ubucyMOAu0=
+github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
+github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
+github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
+github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
+golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4=
+golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.43.0 h1:Rlag2XtaFTxp19wS8MXlJwTvoh8ArU6ezoyFsMyCTNI=
+golang.org/x/sys v0.43.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.36.0 h1:JfKh3XmcRPqZPKevfXVpI1wXPTqbkE5f7JA92a55Yxg=
+golang.org/x/text v0.36.0/go.mod h1:NIdBknypM8iqVmPiuco0Dh6P5Jcdk8lJL0CUebqK164=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/shim/transformers/go.mod

@@ -0,0 +1,14 @@
+module github.com/microsoft/typescript-go/shim/transformers
+
+go 1.26
+
+require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+
+require (
+	github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/zeebo/xxh3 v1.1.0 // indirect
+	golang.org/x/sync v0.20.0 // indirect
+	golang.org/x/sys v0.43.0 // indirect
+	golang.org/x/text v0.36.0 // indirect
+)

package/shim/transformers/go.sum

@@ -0,0 +1,20 @@
+github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 h1:vymEbVwYFP/L05h5TKQxvkXoKxNvTpjxYKdF1Nlwuao=
+github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
+github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157 h1:llOMPhKDiQ+UEJiAaQuuWaJOTg5V7tNNTEf9JPWoYSY=
+github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157/go.mod h1:m8YA0PMC7ti0GW0RI05D6fEcjQeu98XVS+FWF+VDW2k=
+github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
+github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
+github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
+github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
+golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4=
+golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.43.0 h1:Rlag2XtaFTxp19wS8MXlJwTvoh8ArU6ezoyFsMyCTNI=
+golang.org/x/sys v0.43.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.36.0 h1:JfKh3XmcRPqZPKevfXVpI1wXPTqbkE5f7JA92a55Yxg=
+golang.org/x/text v0.36.0/go.mod h1:NIdBknypM8iqVmPiuco0Dh6P5Jcdk8lJL0CUebqK164=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/shim/transformers/shim.go

@@ -0,0 +1,15 @@
+// gen_shims:hand-maintained
+//
+// Re-exports tsgo's emit transformer type so ttsc can build a plugin
+// transformer and run it ahead of the builtin emit chain. Plugins (typia,
+// nestia) return real AST nodes; ttsc inserts their transformer first in the
+// same EmitContext as the builtins, so tsgo's module-transform aliases imports
+// itself, no text-splice needed.
+package transformers
+
+import innertransformers "github.com/microsoft/typescript-go/internal/transformers"
+
+// Transformer is one stage of tsgo's emit transformer chain
+// (TransformSourceFile mutates the SourceFile AST in place within the emit
+// EmitContext).
+type Transformer = innertransformers.Transformer

package/src/compiler/internal/resolveEmittedJavaScript.ts

@@ -34,18 +34,49 @@ export function resolveEmittedJavaScript(options: {
     return exact;
   }
 
+  // Score the pre-computed emit list first (cheap). When it yields nothing —
+  // because the list is incomplete (a native transform host such as typia emits
+  // without printing the `--listEmittedFiles` lines) or because the emit landed
+  // at a path the exact mirror did not predict (tsgo shifts every output path
+  // when the program pulls a raw-`.ts` dependency that sits outside `rootDir`,
+  // so it strips the common source root rather than `rootDir`) — fall back to a
+  // full recursive scan of `outDir`. Trailing-stem scoring still pins the right
+  // file regardless of how deep the shifted prefix is.
+  const primary = bestStemMatch(
+    options.emittedFiles ?? listJavaScriptFiles(options.outDir),
+    options.sourceFile,
+  );
+  if (primary !== null && fs.existsSync(primary)) {
+    return primary;
+  }
+  if (options.emittedFiles !== undefined) {
+    const fromDir = bestStemMatch(
+      listJavaScriptFiles(options.outDir),
+      options.sourceFile,
+    );
+    if (fromDir !== null && fs.existsSync(fromDir)) {
+      return fromDir;
+    }
+  }
+  return null;
+}
+
+/** Highest trailing-stem-scoring JavaScript output among `files`, or `null`. */
+function bestStemMatch(
+  files: readonly string[],
+  sourceFile: string,
+): string | null {
   let best: string | null = null;
   let bestScore = 0;
-  for (const file of options.emittedFiles ??
-    listJavaScriptFiles(options.outDir)) {
+  for (const file of files) {
     if (!isJavaScriptOutput(file)) continue;
-    const score = sharedSourceStemSegments(file, options.sourceFile);
+    const score = sharedSourceStemSegments(file, sourceFile);
     if (score > bestScore) {
       best = file;
       bestScore = score;
     }
   }
-  return best && fs.existsSync(best) ? best : null;
+  return best;
 }
 
 /**

package/src/launcher/internal/prepareExecution.ts

@@ -27,8 +27,11 @@ export function prepareExecution(
 ): {
   cleanupDir: string;
   emitDir: string;
+  emittedFiles?: readonly string[];
   entryFile: string;
-  moduleKind: "cjs" | "esm";
+  moduleOption?: string;
+  projectRoot: string;
+  rootDir: string;
 } {
   const context = createProjectContext(
     path.resolve(options.cwd ?? process.cwd()),
@@ -46,12 +49,14 @@ export function prepareExecution(
     if (emittedEntry === null) {
       throw new Error(`ttsx: emitted entry not found for ${entryFile}`);
     }
-    const output = fs.readFileSync(emittedEntry, "utf8");
     return {
       cleanupDir: context.processDir,
       emitDir: context.emitDir,
+      emittedFiles: context.emittedFiles ?? undefined,
       entryFile: emittedEntry,
-      moduleKind: looksLikeESM(output) ? "esm" : "cjs",
+      moduleOption: context.moduleOption,
+      projectRoot: context.root,
+      rootDir: context.runtimeRootDir,
     };
   } catch (error) {
     removeRuntimeOutput(context.processDir);
@@ -87,6 +92,16 @@ function createProjectContext(
     emitDir: project.compilerOptions.outDir
       ? virtualPath(virtualRoot, project.compilerOptions.outDir)
       : virtualPath(virtualRoot, resolveRuntimeSourceRoot(project, filename)),
+    // The source-tree root the emit mirrors (tsgo strips this prefix). Used to
+    // map a source `.ts` back to its emitted `.js` when the runtime hooks serve
+    // the built entry under its source URL.
+    runtimeRootDir: resolveRuntimeSourceRoot(project, filename),
+    // The tsconfig `module` option, so the runtime hooks classify each served
+    // file's format the same way tsgo chose when emitting it.
+    moduleOption:
+      typeof project.compilerOptions.module === "string"
+        ? project.compilerOptions.module
+        : undefined,
     built: false,
     emittedFiles: undefined as string[] | undefined,
   };
@@ -261,21 +276,3 @@ function virtualPath(root: string, absolute: string): string {
   const relative = path.relative(parsed.root, path.resolve(absolute));
   return path.join(root, label, relative);
 }
-
-/**
- * Heuristic: classify emitted JS as ESM when it contains top-level `import` or
- * `export` statements but none of the well-known CJS patterns. The CJS checks
- * run first so that re-exported CJS bundles with both `require` calls and an
- * `export` declaration are conservatively treated as CJS.
- */
-function looksLikeESM(output: string): boolean {
-  if (
-    /\bObject\.defineProperty\(exports\b/.test(output) ||
-    /\bmodule\.exports\b/.test(output) ||
-    /\brequire\(/.test(output) ||
-    /\bexports\./.test(output)
-  ) {
-    return false;
-  }
-  return /^\s*(import|export)\s/m.test(output);
-}

package/src/launcher/internal/registerRuntimeHooks.ts

@@ -1,14 +1,59 @@
-import { register } from "node:module";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 
+import { entryModuleFormat, installRuntimeHooks } from "./runtimeHooks";
+
 /**
- * `--import` entry point that installs `ttsx`'s runtime module hooks in the
- * child process. Run before the compiled entry so the `resolve`/`load` hooks in
- * `runtimeHooks` are active for the whole dependency graph.
+ * Bootstrap `ttsx` spawns as the child's main module: it installs the runtime
+ * module hooks, then loads the TypeScript entry _from source_.
+ *
+ * Why load the entry here instead of passing it as Node's main entry: a
+ * CommonJS `require("./x")` chain only reaches `module.registerHooks` when the
+ * entry itself is loaded through a CommonJS `require`. Running the `.ts` as
+ * Node's ESM-first main entry leaves inner `require`s on the native loader,
+ * where they cannot resolve a sibling `.ts`. So the parent invokes `node
+ * registerRuntimeHooks.js <entry> [argv...]` and we `require()` (or dynamically
+ * `import()`) the entry after the hooks are live.
  *
- * Kept as a dedicated, dependency-free module: it must load in the child's
- * plain Node runtime (not ttsc's), so it pulls in nothing beyond Node builtins
- * and the sibling hooks file.
+ * `process.argv` is rewritten to `[node, <entry>, ...argv]` so the program sees
+ * the same argv it would under a direct `node <entry>` invocation.
  */
-register(pathToFileURL(path.join(__dirname, "runtimeHooks.js")).href);
+const entry = process.argv[2];
+if (entry === undefined) {
+  process.stderr.write("ttsx: internal error — no entry passed to bootstrap\n");
+  process.exit(2);
+}
+
+const forwarded = process.argv.slice(3);
+process.argv = [process.argv[0]!, entry, ...forwarded];
+
+installRuntimeHooks();
+
+const kind = entryModuleFormat(path.resolve(entry));
+
+function fail(error: unknown): never {
+  // Match Node's own uncaught-exception surfacing for a thrown entry error.
+  process.stderr.write(
+    `${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`,
+  );
+  process.exit(1);
+}
+
+// A genuine dynamic `import()`. Authored directly it would be downlevelled to a
+// `require()` shim under this package's CommonJS emit, which cannot load a
+// `file:` URL or an ESM module — so build it through `Function` to keep it an
+// `import` at runtime.
+const dynamicImport = new Function(
+  "specifier",
+  "return import(specifier);",
+) as (specifier: string) => Promise<unknown>;
+
+if (kind === "module") {
+  dynamicImport(pathToFileURL(path.resolve(entry)).href).catch(fail);
+} else {
+  try {
+    require(path.resolve(entry));
+  } catch (error) {
+    fail(error);
+  }
+}