ttsc 0.10.2 → 0.11.0-dev.20260517

package/lib/structures/ITtscCompilerResult.d.ts

@@ -2,8 +2,8 @@ import type { ITtscCompilerDiagnostic } from "./ITtscCompilerDiagnostic";
 /**
  * Result of a ttsc TypeScript-Go compilation operation.
  *
- * Represents the possible outcomes of {@link TtscCompiler.compile}, which can
- * be either a successful compilation, a compilation that completed with
+ * Represents the possible outcomes of {@link TtscCompiler.compile}, which can be
+ * either a successful compilation, a compilation that completed with
  * diagnostics, or an unexpected host error during the compilation process.
  *
  * This type follows the legacy `embed-typescript` result model, but stores all
@@ -20,17 +20,13 @@ export declare namespace ITtscCompilerResult {
      * Represents a successful ttsc compilation result.
      *
      * This interface is returned when TypeScript-Go completes without
-     * diagnostics, containing every text output captured from the native
-     * compiler host's `WriteFile` callback.
+     * diagnostics, containing every text output captured from the native compiler
+     * host's `WriteFile` callback.
      */
     interface ISuccess {
-        /**
-         * Indicates that the compilation was successful.
-         */
+        /** Indicates that the compilation was successful. */
         type: "success";
-        /**
-         * Non-fatal diagnostics reported during compilation.
-         */
+        /** Non-fatal diagnostics reported during compilation. */
         diagnostics?: ITtscCompilerDiagnostic[];
         /**
          * The generated compiler output.
@@ -51,13 +47,9 @@ export declare namespace ITtscCompilerResult {
      * diagnostics.
      */
     interface IFailure {
-        /**
-         * Indicates that compilation completed with diagnostics.
-         */
+        /** Indicates that compilation completed with diagnostics. */
         type: "failure";
-        /**
-         * Array of diagnostic messages describing the compilation issues.
-         */
+        /** Array of diagnostic messages describing the compilation issues. */
         diagnostics: ITtscCompilerDiagnostic[];
         /**
          * Any compiler output that was generated despite the diagnostics.
@@ -75,13 +67,9 @@ export declare namespace ITtscCompilerResult {
      * {@link IFailure}; this variant is reserved for host-level exceptions.
      */
     interface IException {
-        /**
-         * Indicates that an unexpected host error occurred.
-         */
+        /** Indicates that an unexpected host error occurred. */
         type: "exception";
-        /**
-         * The error that was thrown while preparing or running the compiler host.
-         */
+        /** The error that was thrown while preparing or running the compiler host. */
         error: unknown;
     }
 }

package/lib/structures/ITtscCompilerTransformation.d.ts

@@ -3,8 +3,8 @@ import type { ITtscCompilerDiagnostic } from "./ITtscCompilerDiagnostic";
  * Result of a TypeScript source-to-source transformation operation.
  *
  * This mirrors `embed-typescript`'s `IEmbedTypeScriptTransformation` model.
- * Unlike {@link ITtscCompilerResult}, this contract is not an emit contract:
- * the `typescript` map must contain TypeScript source text, not generated
+ * Unlike {@link ITtscCompilerResult}, this contract is not an emit contract: the
+ * `typescript` map must contain TypeScript source text, not generated
  * JavaScript, declaration files, or source maps.
  */
 export type ITtscCompilerTransformation = ITtscCompilerTransformation.ISuccess | ITtscCompilerTransformation.IFailure | ITtscCompilerTransformation.IException;

package/lib/structures/ITtscPlugin.d.ts

@@ -1,3 +1,4 @@
+import type { ITtscPluginContributor } from "./ITtscPluginContributor";
 import type { TtscPluginStage } from "./TtscPluginStage";
 /**
  * Runtime descriptor returned by a ttsc plugin module.
@@ -26,7 +27,7 @@ export interface ITtscPlugin {
     /**
      * Go command package directory, or a `go.mod` file, that ttsc lazily builds.
      *
-     * ttsc accepts source only. It does not accept a prebuilt binary path: the
+     * Ttsc accepts source only. It does not accept a prebuilt binary path: the
      * package-local Go compiler builds this source into the ttsc plugin cache on
      * demand.
      *
@@ -56,11 +57,43 @@ export interface ITtscPlugin {
      * Pipeline stage implemented by the sidecar.
      *
      * Omit this field for normal compiler-transform plugins. The only explicit
-     * non-transform stage is `"check"`.
+     * non-transform stage is `"check"`. Check-stage plugins receive `check`
+     * during normal builds and may implement `fix` for `ttsc fix` and `format`
+     * for `ttsc format`.
      *
      * @default "transform"
      */
     stage?: TtscPluginStage;
+    /**
+     * Additional Go source packages to statically link into this plugin's binary
+     * at build time ("plugin-within-plugin" composition).
+     *
+     * Each contributor's Go source directory is copied into the scratch build
+     * tree as a sub-package of this plugin's module and reached by a synthesized
+     * blank import. The contributor's `init()` runs before the host binary's
+     * `main`, registering whatever state the host expects to find at startup
+     * (e.g. lint rules through `github.com/samchon/ttsc/packages/lint/rule`).
+     *
+     * Differs from `composes`:
+     *
+     * - `composes` is horizontal — many plugin entries dispatch to one binary by
+     *   name. Each entry is still a top-level `compilerOptions.plugins[]` citizen
+     *   with its own lifecycle slot.
+     * - `contributors` is vertical — one binary statically links additional Go
+     *   sources that never appear as top-level plugin entries. The contributing
+     *   npm packages are discovered through the host plugin's own config file
+     *   (e.g. `lint.config.ts` for `@ttsc/lint`).
+     *
+     * Constraints:
+     *
+     * - Contributors ship Go source as a package (no `go.mod`); the host plugin's
+     *   module supplies every transitive Go dependency. This is also a
+     *   supply-chain feature — contributors cannot pull in arbitrary Go modules
+     *   at build time.
+     * - Contributor source paths must be absolute (the host plugin's JS factory
+     *   typically resolves them through `require.resolve`).
+     * - Contributor names are used as the sub-package import suffix and must be
+     *   unique within a single plugin build.
+     */
+    contributors?: ITtscPluginContributor[];
 }
-export declare function defineTtscPlugin<T extends ITtscPlugin>(plugin: T): T;
-export declare function defineTtscPlugin<TContext, T extends ITtscPlugin>(factory: (context: TContext) => T): (context: TContext) => T;

package/lib/structures/ITtscPlugin.js

@@ -1,7 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineTtscPlugin = defineTtscPlugin;
-function defineTtscPlugin(value) {
-    return value;
-}
 //# sourceMappingURL=ITtscPlugin.js.map

package/lib/structures/ITtscPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"ITtscPlugin.js","sourceRoot":"","sources":["../../src/structures/ITtscPlugin.ts"],"names":[],"mappings":";;;AAyEA,0BACE,KAAwD;IAExD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"ITtscPlugin.js","sourceRoot":"","sources":["../../src/structures/ITtscPlugin.ts"],"names":[],"mappings":""}

package/lib/structures/ITtscPluginContributor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * One contributor entry inside `ITtscPlugin.contributors`.
+ *
+ * The native builder copies `source` into `<scratch>/contrib/<name>/` and adds
+ * a blank-import for `<host-module>/contrib/<name>` to the synthesized
+ * `ttsc_contributions.go` placed alongside the host's main package.
+ */
+export interface ITtscPluginContributor {
+    /**
+     * Sub-package name.
+     *
+     * Forms the final import path together with the host plugin's Go module path;
+     * must match `/^[a-z][a-z0-9_]*$/` — a lowercase ASCII letter followed by
+     * lowercase letters, digits, or underscores — and be unique within one plugin
+     * build.
+     */
+    name: string;
+    /**
+     * Absolute path to the contributor's Go source directory.
+     *
+     * Every `.go` file under this directory is copied into the scratch build tree
+     * as a sub-package of the host plugin's module. Subdirectories are copied
+     * recursively; `go.mod` files, `node_modules`, and `.git` are pruned.
+     */
+    source: string;
+}

package/lib/structures/ITtscPluginContributor.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITtscPluginContributor.js.map

package/lib/structures/ITtscPluginContributor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITtscPluginContributor.js","sourceRoot":"","sources":["../../src/structures/ITtscPluginContributor.ts"],"names":[],"mappings":""}

package/lib/structures/ITtscPluginFactoryContext.d.ts

@@ -9,8 +9,8 @@ import type { ITtscProjectPluginConfig } from "./ITtscProjectPluginConfig";
  * project root.
  *
  * The factory runs in Node.js while ttsc is loading `compilerOptions.plugins`.
- * It should only create the descriptor. Heavy validation and TypeScript-Go
- * work belong in the Go sidecar selected by {@link ITtscPlugin.source}.
+ * It should only create the descriptor. Heavy validation and TypeScript-Go work
+ * belong in the Go sidecar selected by {@link ITtscPlugin.source}.
  */
 export interface ITtscPluginFactoryContext<T = ITtscProjectPluginConfig> {
     /**
@@ -18,8 +18,8 @@ export interface ITtscPluginFactoryContext<T = ITtscProjectPluginConfig> {
      *
      * This is the package's own native helper, not the plugin sidecar and not the
      * JavaScript launcher. Most plugins do not need it; it is provided for
-     * advanced factories that need to derive behavior from the active ttsc
-     * native host.
+     * advanced factories that need to derive behavior from the active ttsc native
+     * host.
      */
     binary: string;
     /**
@@ -33,7 +33,7 @@ export interface ITtscPluginFactoryContext<T = ITtscProjectPluginConfig> {
     /**
      * Original `compilerOptions.plugins[]` entry that loaded this plugin.
      *
-     * ttsc reserves `transform` and `enabled`. Every other property is
+     * Ttsc reserves `transform` and `enabled`. Every other property is
      * plugin-owned config and is later serialized unchanged into the native
      * sidecar manifest.
      */

package/lib/structures/ITtscProjectPluginConfig.d.ts

@@ -6,7 +6,7 @@
  * or plugin packages expose through `package.json`. ttsc deliberately keeps it
  * open-ended because plugin packages own their own config fields.
  *
- * ttsc interprets only two properties:
+ * Ttsc interprets only two properties:
  *
  * - `transform`: the JavaScript module specifier used to load the plugin
  *   descriptor or factory.
@@ -40,7 +40,7 @@ export interface ITtscProjectPluginConfig {
     /**
      * Plugin-specific config passed through unchanged to the native sidecar.
      *
-     * ttsc does not validate these fields. Plugin packages should document their
+     * Ttsc does not validate these fields. Plugin packages should document their
      * own config contract and validate it inside their factory or Go sidecar.
      */
     [key: string]: unknown;

package/lib/structures/TtscPluginStage.d.ts

@@ -3,8 +3,9 @@
  *
  * - `"transform"`: participates in the TypeScript-Go transform path. Transform
  *   plugins do not receive emitted JavaScript or emitted file text.
- * - `"check"`: runs before emit and reports diagnostics only. Use this for
- *   lint or validation plugins that should fail the compile before JavaScript
- *   or declaration output is generated.
+ * - `"check"`: runs before emit and reports diagnostics. Use this for lint or
+ *   validation plugins that should fail the compile before JavaScript or
+ *   declaration output is generated. Check plugins may also implement a `fix`
+ *   command, which `ttsc fix` invokes with emit disabled.
  */
 export type TtscPluginStage = "transform" | "check";

package/lib/structures/index.d.ts

@@ -3,6 +3,7 @@ export * from "./ITtscCompilerDiagnostic";
 export * from "./ITtscCompilerResult";
 export * from "./ITtscCompilerTransformation";
 export * from "./ITtscPlugin";
+export * from "./ITtscPluginContributor";
 export * from "./ITtscPluginFactoryContext";
 export * from "./ITtscProjectPluginConfig";
 export * from "./TtscPluginStage";

package/lib/structures/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./ITtscCompilerDiagnostic"), exports);
 __exportStar(require("./ITtscCompilerResult"), exports);
 __exportStar(require("./ITtscCompilerTransformation"), exports);
 __exportStar(require("./ITtscPlugin"), exports);
+__exportStar(require("./ITtscPluginContributor"), exports);
 __exportStar(require("./ITtscPluginFactoryContext"), exports);
 __exportStar(require("./ITtscProjectPluginConfig"), exports);
 __exportStar(require("./TtscPluginStage"), exports);

package/lib/structures/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,4DAA0C;AAC1C,wDAAsC;AACtC,gEAA8C;AAC9C,gDAA8B;AAC9B,8DAA4C;AAC5C,6DAA2C;AAC3C,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,4DAA0C;AAC1C,wDAAsC;AACtC,gEAA8C;AAC9C,gDAA8B;AAC9B,2DAAyC;AACzC,8DAA4C;AAC5C,6DAA2C;AAC3C,oDAAkC"}

package/lib/structures/internal/ITtscLoadedNativePlugin.d.ts

@@ -1,3 +1,4 @@
+import type { ITtscPluginContributor } from "../ITtscPluginContributor";
 import type { ITtscProjectPluginConfig } from "../ITtscProjectPluginConfig";
 import type { TtscPluginStage } from "../TtscPluginStage";
 /** Native sidecar selected and built from one plugin descriptor. */
@@ -6,6 +7,8 @@ export interface ITtscLoadedNativePlugin {
     binary: string;
     /** Original tsconfig plugin entry passed unchanged to the sidecar. */
     config: ITtscProjectPluginConfig;
+    /** Contributor Go sources statically linked into the binary, if any. */
+    contributors?: readonly ITtscPluginContributor[];
     /** Stable plugin name used in diagnostics and native manifests. */
     name: string;
     /** Go source directory selected by the plugin descriptor. */

package/lib/structures/internal/TtscBuildOptions.d.ts

@@ -11,6 +11,19 @@ export interface TtscBuildOptions extends TtscCommonOptions {
      * - `undefined`: follow the resolved tsconfig exactly.
      */
     emit?: boolean;
+    /**
+     * Invoke fix-capable check-stage plugins before the final no-emit check.
+     * Source files may be rewritten; JavaScript/declaration emit stays disabled.
+     */
+    fix?: boolean;
+    /**
+     * Invoke format-capable check-stage plugins. Source files may be rewritten
+     * with formatter-class edits (whitespace, punctuation, ordering); diagnostics
+     * are not reported and JavaScript/declaration emit stays disabled. The
+     * launcher selects this through the `ttsc format` subcommand and rejects
+     * combination with watch mode, single-file mode, or an explicit `--emit`.
+     */
+    format?: boolean;
     /** Per-call TypeScript-Go `outDir` override. */
     outDir?: string;
     /** Suppress summary banners from ttsc/native sidecars. Defaults to `true`. */

package/lib/structures/internal/TtscCommonOptions.d.ts

@@ -1,5 +1,8 @@
 import type { ITtscProjectPluginConfig } from "../ITtscProjectPluginConfig";
-/** Internal options shared by the CLI build, single-file emit, and runtime paths. */
+/**
+ * Internal options shared by the CLI build, single-file emit, and runtime
+ * paths.
+ */
 export interface TtscCommonOptions {
     /**
      * Explicit TypeScript-Go executable.
@@ -22,7 +25,7 @@ export interface TtscCommonOptions {
      * Override project plugin loading for this invocation.
      *
      * - `false`: ignore `compilerOptions.plugins` completely.
-     * - array: use these plugin entries instead of the project config entries.
+     * - Array: use these plugin entries instead of the project config entries.
      * - `undefined`: use the project config entries as written.
      */
     plugins?: readonly ITtscProjectPluginConfig[] | false;

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "ttsc",
-  "version": "0.10.2",
+  "version": "0.11.0-dev.20260517",
   "description": "General-purpose TypeScript-Go compiler, plugin host, and runtime.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "bin": {
     "ttsc": "lib/launcher/ttsc.js",
+    "ttscserver": "lib/launcher/ttscserver.js",
     "ttsx": "lib/launcher/ttsx.js"
   },
   "exports": {
@@ -27,17 +28,17 @@
   "homepage": "https://github.com/samchon/ttsc",
   "devDependencies": {
     "@types/node": "^25.3.0",
-    "@typescript/native-preview": "7.0.0-dev.20260510.1",
+    "@typescript/native-preview": "7.0.0-dev.20260515.1",
     "rimraf": "^6.1.2"
   },
   "optionalDependencies": {
-    "@ttsc/linux-x64": "0.10.2",
-    "@ttsc/linux-arm": "0.10.2",
-    "@ttsc/darwin-x64": "0.10.2",
-    "@ttsc/linux-arm64": "0.10.2",
-    "@ttsc/darwin-arm64": "0.10.2",
-    "@ttsc/win32-arm64": "0.10.2",
-    "@ttsc/win32-x64": "0.10.2"
+    "@ttsc/linux-x64": "0.11.0-dev.20260517",
+    "@ttsc/win32-x64": "0.11.0-dev.20260517",
+    "@ttsc/darwin-arm64": "0.11.0-dev.20260517",
+    "@ttsc/win32-arm64": "0.11.0-dev.20260517",
+    "@ttsc/linux-arm": "0.11.0-dev.20260517",
+    "@ttsc/linux-arm64": "0.11.0-dev.20260517",
+    "@ttsc/darwin-x64": "0.11.0-dev.20260517"
   },
   "sideEffects": false,
   "files": [

package/shim/lsp/extra-shim.json

@@ -0,0 +1,4 @@
+{
+  "ExtraMethods": {},
+  "ExtraFields": {}
+}

package/shim/lsp/go.mod

@@ -0,0 +1,16 @@
+module github.com/microsoft/typescript-go/shim/lsp
+
+go 1.26
+
+require github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157
+
+require (
+	github.com/Microsoft/go-winio v0.6.2 // indirect
+	github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/mackerelio/go-osstat v0.2.7 // 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/lsp/go.sum

@@ -0,0 +1,26 @@
+github.com/Microsoft/go-winio v0.6.2 h1:F2VQgta7ecxGYO8k3ZZz3RS8fVIXVxONVUPlNERoyfY=
+github.com/Microsoft/go-winio v0.6.2/go.mod h1:yd8OoFMLzJbo9gZq8j5qaps8bJ9aShtEA8Ipt1oGCvU=
+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/mackerelio/go-osstat v0.2.7 h1:TCavZi10wF49bT6iQZ9eT2keGZQpC69MTDfdJej5e94=
+github.com/mackerelio/go-osstat v0.2.7/go.mod h1:dwpYh5pIPmvk+IEwBKNIWRFMB92mrC08CmXOhDC7nQk=
+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/lsp/shim.go

@@ -0,0 +1,42 @@
+// gen_shims:hand-maintained
+//
+// Minimal shim of tsgo's internal/lsp package. Hand-written instead of
+// generated so the surface stays narrow: ttscserver embeds the tsgo LSP
+// server unmodified and intercepts traffic at the byte level, so the only
+// types it touches are the opaque Server, its options struct, and the
+// Reader/Writer interfaces that ToReader/ToWriter return. The marker on
+// the first line tells gen_shims to skip this file.
+package lsp
+
+import (
+  "io"
+  _ "unsafe"
+
+  innerlsp "github.com/microsoft/typescript-go/internal/lsp"
+)
+
+// Server is the opaque LSP server type from tsgo. ttscserver does not poke
+// its internals; it only calls Run and (via wrapped Writer) observes the
+// traffic the server emits.
+type Server = innerlsp.Server
+
+// ServerOptions mirrors the upstream construction parameters. Fields with
+// internal-package types (e.g. ParseCache *project.ParseCache) are left
+// unset by ttscserver, which is safe because every such field is an
+// optional pointer the upstream constructor accepts as nil.
+type ServerOptions = innerlsp.ServerOptions
+
+// Reader / Writer carry framed lsproto.Message values. ttscserver feeds
+// the server through io.Pipe shims of these so it can splice its own
+// JSON-RPC traffic into the same stream the editor speaks.
+type Reader = innerlsp.Reader
+type Writer = innerlsp.Writer
+
+//go:linkname NewServer github.com/microsoft/typescript-go/internal/lsp.NewServer
+func NewServer(opts *ServerOptions) *Server
+
+//go:linkname ToReader github.com/microsoft/typescript-go/internal/lsp.ToReader
+func ToReader(r io.Reader) Reader
+
+//go:linkname ToWriter github.com/microsoft/typescript-go/internal/lsp.ToWriter
+func ToWriter(w io.Writer) Writer

package/shim/printer/shim.go

@@ -1,8 +1,8 @@
 package printer
 
 import (
-	"github.com/microsoft/typescript-go/internal/ast"
-	innerprinter "github.com/microsoft/typescript-go/internal/printer"
+  "github.com/microsoft/typescript-go/internal/ast"
+  innerprinter "github.com/microsoft/typescript-go/internal/printer"
 )
 
 type PrintHandlers = innerprinter.PrintHandlers
@@ -11,13 +11,13 @@ type PrinterOptions = innerprinter.PrinterOptions
 type EmitContext = innerprinter.EmitContext
 
 func NewPrinter(options PrinterOptions, handlers PrintHandlers, emitContext *EmitContext) *Printer {
-	return innerprinter.NewPrinter(options, handlers, emitContext)
+  return innerprinter.NewPrinter(options, handlers, emitContext)
 }
 
 func NewEmitContext() *EmitContext {
-	return innerprinter.NewEmitContext()
+  return innerprinter.NewEmitContext()
 }
 
 func EmitSourceFile(p *Printer, sourceFile *ast.SourceFile) string {
-	return p.EmitSourceFile(sourceFile)
+  return p.EmitSourceFile(sourceFile)
 }

package/src/TtscCompiler.ts

@@ -15,23 +15,22 @@ import type { TtscBuildResult } from "./structures/internal/TtscBuildResult";
 /**
  * Programmatic compiler host for the `ttsc` TypeScript-Go pipeline.
  *
- * `TtscCompiler` is the root JavaScript API exported by the `ttsc` package.
- * It represents one resolved project context: a working directory, an optional
- * project config path, an optional native toolchain override, an environment,
- * a cache root, and a plugin list. Those values are captured by the
- * constructor and are intentionally not replaceable per method call.
+ * `TtscCompiler` is the root JavaScript API exported by the `ttsc` package. It
+ * represents one resolved project context: a working directory, an optional
+ * project config path, an optional native toolchain override, an environment, a
+ * cache root, and a plugin list. Those values are captured by the constructor
+ * and are intentionally not replaceable per method call.
  *
  * The class exposes only the operations that make sense for an embedded
  * compiler host:
  *
  * - {@link TtscCompiler.prepare}: build configured Go source plugins into the
  *   cache before a later compile.
- * - {@link TtscCompiler.clean}: remove the cache owned by this compiler
- *   context.
+ * - {@link TtscCompiler.clean}: remove the cache owned by this compiler context.
  * - {@link TtscCompiler.compile}: compile the configured project and return a
  *   structured result instead of terminal text.
- * - {@link TtscCompiler.transform}: transform the configured project and
- *   return an embed-style transformation result.
+ * - {@link TtscCompiler.transform}: transform the configured project and return an
+ *   embed-style transformation result.
  */
 export class TtscCompiler {
   private readonly context: ITtscCompilerContext;
@@ -106,14 +105,14 @@ export class TtscCompiler {
    *
    * The public API does not write emitted files into the caller's project tree.
    * For projects without plugins, ttsc uses its native TypeScript-Go host's
-   * `WriteFile` callback to capture output in memory. For projects with
-   * native plugins, ttsc runs the plugin pipeline against a temporary output
+   * `WriteFile` callback to capture output in memory. For projects with native
+   * plugins, ttsc runs the plugin pipeline against a temporary output
    * directory, reads the generated text artifacts, and removes the temporary
    * directory before returning.
    *
-   * The result uses an `embed-typescript`-style discriminated union:
-   * `success` for clean compiles, `failure` for normal compiler diagnostics,
-   * and `exception` for host setup or process failures.
+   * The result uses an `embed-typescript`-style discriminated union: `success`
+   * for clean compiles, `failure` for normal compiler diagnostics, and
+   * `exception` for host setup or process failures.
    *
    * @returns Structured compilation result containing diagnostics or output.
    */
@@ -127,8 +126,8 @@ export class TtscCompiler {
    * This is the source-to-source API for plugin authors. It must not return
    * JavaScript emit, declaration files, or source maps; those artifacts belong
    * to {@link TtscCompiler.compile}. A transform sidecar is expected to write
-   * JSON shaped as `{ "typescript": { "src/file.ts": "..." } }` to stdout.
-   * When no transform sidecar is configured, ttsc returns the TypeScript files
+   * JSON shaped as `{ "typescript": { "src/file.ts": "..." } }` to stdout. When
+   * no transform sidecar is configured, ttsc returns the TypeScript files
    * loaded by the TypeScript-Go Program together with normal diagnostics.
    *
    * The returned shape mirrors `embed-typescript`'s transformation API:

package/src/compiler/internal/compileProjectInMemory.ts

@@ -12,7 +12,10 @@ import { buildNativeCompiler } from "./buildNativeCompiler";
 import { readProjectConfig } from "./project/readProjectConfig";
 import { runBuild } from "./runBuild";
 
-/** Compile a project and capture emitted files without writing to the project tree. */
+/**
+ * Compile a project and capture emitted files without writing to the project
+ * tree.
+ */
 export function compileProjectInMemory(options: ITtscCompilerContext): {
   output: Record<string, string>;
   result: TtscBuildResult;

package/src/compiler/internal/project/readProjectConfig.ts

@@ -5,7 +5,6 @@ import path from "node:path";
 import type { ITtscProjectPluginConfig } from "../../../structures/ITtscProjectPluginConfig";
 import type { ITtscParsedProjectConfig } from "../../../structures/internal/ITtscParsedProjectConfig";
 import type { ITtscProjectLocatorOptions } from "../../../structures/internal/ITtscProjectLocatorOptions";
-
 import { resolveProjectConfig } from "./resolveProjectConfig";
 
 const PATH_OPTIONS = new Set(["baseUrl", "declarationDir", "rootDir"]);