ttsc 0.19.3 → 0.20.0

package/internal/lspserver/lsp_refresh.go

@@ -0,0 +1,70 @@
+package lspserver
+
+import "sync"
+
+// coalescingRefresh runs a background task at most once at a time, collapsing
+// every request that arrives while a run is in flight into a single rerun.
+//
+// It exists because editor notifications arrive in bursts — a multi-file save,
+// a watched-file rewrite, a settings change — while the task behind them costs a
+// process spawn and a Program load. Running one per notification would stack
+// those spawns; dropping the extras would leave the corpus a generation behind
+// the edit that caused them. Coalescing keeps exactly one rerun, which is the
+// smallest amount of work that still observes the newest state.
+//
+// Each run receives a strictly increasing generation so a writer can reject a
+// result that a newer run has already superseded. The zero value is ready to
+// use, and the task is supplied per schedule call so the owner does not have to
+// wire it at construction.
+type coalescingRefresh struct {
+  mu         sync.Mutex
+  task       func(generation uint64)
+  generation uint64
+  running    bool
+  queued     bool
+}
+
+// schedule requests a run of task. It returns immediately: the run happens on
+// its own goroutine, and a request made while a run is in flight becomes the one
+// queued rerun rather than a second concurrent run.
+func (r *coalescingRefresh) schedule(task func(generation uint64)) {
+  if task == nil {
+    return
+  }
+  r.mu.Lock()
+  r.task = task
+  if r.running {
+    r.queued = true
+    r.mu.Unlock()
+    return
+  }
+  r.running = true
+  r.generation++
+  generation := r.generation
+  r.mu.Unlock()
+  go r.run(generation)
+}
+
+// run executes the task, then drains a queued request in the same goroutine so
+// two cycles never overlap. Looping rather than spawning keeps the invariant the
+// generation guard depends on: within one refresher, cycles are serial.
+func (r *coalescingRefresh) run(generation uint64) {
+  for {
+    r.mu.Lock()
+    task := r.task
+    r.mu.Unlock()
+    if task != nil {
+      task(generation)
+    }
+    r.mu.Lock()
+    if !r.queued {
+      r.running = false
+      r.mu.Unlock()
+      return
+    }
+    r.queued = false
+    r.generation++
+    generation = r.generation
+    r.mu.Unlock()
+  }
+}

package/internal/lspserver/lsp_resident_falls_back_when_serve_unsupported_test.go

@@ -0,0 +1,43 @@
+package lspserver
+
+import (
+  "bytes"
+  "testing"
+)
+
+// TestResidentFallsBackWhenServeUnsupported verifies a sidecar that cannot serve
+// degrades to the spawn-per-verb path instead of losing the verb.
+//
+// Every sidecar built before lsp-serve rejects it, and a resident child can also
+// fail to spawn; either way the read verb must still run. serveRun signals that
+// by returning served=false so run() falls through to exec. It must also mark
+// the binary unsupported after a first-spawn failure, or the source would
+// spawn-and-fail per request forever.
+//
+// A binary that cannot be launched reaches the same spawn error as a sidecar
+// that rejects the verb, so an unresolvable name is a faithful stand-in and
+// keeps the test from needing a compiled fixture (mirrors the hint-absence
+// test).
+//
+//  1. serveRun a read verb against a plugin whose binary cannot launch.
+//  2. Assert it reports served=false (the caller falls back to exec).
+//  3. Assert the binary is marked unsupported, and a second call short-circuits.
+func TestResidentFallsBackWhenServeUnsupported(t *testing.T) {
+  source := &NativePluginSource{err: &bytes.Buffer{}}
+  plugin := NativeLSPPluginEntry{Binary: "ttsc-no-such-serve-binary", Name: "@ttsc/legacy"}
+
+  if _, served, _ := source.serveRun(plugin, serveVerbDiagnostics, []string{"--uri=file:///a.ts"}); served {
+    t.Fatal("a sidecar that cannot spawn must fall back to exec (served=false)")
+  }
+
+  source.residentMu.Lock()
+  unsupported := source.serveUnsupported[plugin.Binary]
+  source.residentMu.Unlock()
+  if !unsupported {
+    t.Fatal("a first-spawn failure must mark lsp-serve unsupported so the source stops retrying")
+  }
+
+  if _, served, _ := source.serveRun(plugin, serveVerbDiagnostics, []string{"--uri=file:///a.ts"}); served {
+    t.Fatal("a binary already marked unsupported must keep falling back")
+  }
+}

package/internal/lspserver/lsp_resident_maps_verb_args_test.go

@@ -0,0 +1,34 @@
+package lspserver
+
+import "testing"
+
+// TestResidentMapsVerbArgs verifies the resident client rebuilds a serve request
+// from the same --flag=value argv the spawn-per-verb path passes.
+//
+// The two transports share one call shape at the source's verb methods:
+// Diagnostics/CodeActions build `--uri=`, `--range-json=`, `--context-json=`
+// argv, and serveRun must map those back into the request the daemon reads, or
+// a code-action would arrive at the warm Program with no range and quietly
+// offer nothing.
+//
+//  1. Map a code-actions argv carrying all three fields.
+//  2. Assert each field lands, verbatim, including JSON payloads.
+func TestResidentMapsVerbArgs(t *testing.T) {
+  req := serveRequestFromArgs("lsp-code-actions", []string{
+    "--uri=file:///a.ts",
+    `--range-json={"start":{"line":1,"character":2}}`,
+    `--context-json={"only":["quickfix.ttsc"]}`,
+  })
+  if req.Verb != "lsp-code-actions" {
+    t.Fatalf("verb = %q, want lsp-code-actions", req.Verb)
+  }
+  if req.URI != "file:///a.ts" {
+    t.Fatalf("uri = %q", req.URI)
+  }
+  if req.RangeJSON != `{"start":{"line":1,"character":2}}` {
+    t.Fatalf("rangeJson = %q", req.RangeJSON)
+  }
+  if req.ContextJSON != `{"only":["quickfix.ttsc"]}` {
+    t.Fatalf("contextJson = %q", req.ContextJSON)
+  }
+}

package/internal/lspserver/lsp_server.go

@@ -148,7 +148,10 @@ func defaultUpstreamRunner(ctx context.Context, in io.Reader, out io.Writer, opt
 // RunLSPServer starts an upstream `tsgo --lsp --stdio` process and the byte-level
 // proxy, blocking until either side returns. The first non-graceful
 // error wins; ErrFrameClosed and context cancellation are treated as
-// clean shutdown so editor close sequences do not look like crashes.
+// clean shutdown so editor close sequences do not look like crashes. Once the
+// editor has sent `exit`, an upstream runner failure joins that set: the
+// upstream is required to terminate at that point, so its status no longer
+// describes the session (see Proxy.editorRequestedExit).
 //
 // The lifecycle is:
 //
@@ -231,6 +234,15 @@ func RunLSPServer(ctx context.Context, opts LSPServerOptions) error {
     proxyErr = proxy.Run(serverCtx)
   }()
   wg.Wait()
+  proxy.shutdownResidentPlugins()
+
+  if proxy.editorRequestedExit() {
+    // The editor asked the server to quit, so the upstream process ending is
+    // the point rather than a fault. See Proxy.editorRequestedExit for why its
+    // status is not a reliable signal at that moment. Proxy errors still
+    // surface: those are ttsc's own.
+    serverErr = nil
+  }
 
   for _, err := range []error{serverErr, proxyErr} {
     if err == nil {

package/internal/lspserver/lsp_watched_file_changes_reach_compiler_caches_test.go

@@ -0,0 +1,172 @@
+package lspserver
+
+import (
+  "encoding/json"
+  "io"
+  "testing"
+)
+
+// watchedFilesSource records resident invalidations for the watched-file matrix.
+type watchedFilesSource struct {
+  NullPluginSource
+  calls [][]string
+}
+
+func (s *watchedFilesSource) InvalidateResidentPrograms(uris ...string) {
+  s.calls = append(s.calls, append([]string(nil), uris...))
+}
+
+type watchedFilesSymbolProvider struct{ invalidations int }
+
+func (p *watchedFilesSymbolProvider) DocumentSymbols(string) ([]LSPDocumentSymbol, error) {
+  return nil, nil
+}
+
+func (p *watchedFilesSymbolProvider) References(string, LSPPosition, bool) ([]LSPLocation, error) {
+  return nil, nil
+}
+
+func (p *watchedFilesSymbolProvider) Invalidate() { p.invalidations++ }
+
+func watchedFilesEnvelope(t *testing.T, params string) Envelope {
+  t.Helper()
+  if !json.Valid([]byte(params)) {
+    t.Fatalf("invalid watched-file params: %s", params)
+  }
+  return Envelope{
+    JSONRPC: "2.0",
+    Method:  methodDidChangeWatchedFiles,
+    Params:  json.RawMessage(params),
+  }
+}
+
+// TestLSPWatchedFileChangesReachCompilerCaches verifies that a
+// workspace/didChangeWatchedFiles batch refreshes both compiler-backed caches,
+// and that only a plain edit to a plain source file is refreshed incrementally.
+//
+// The repository's VS Code client watches `**/{tsconfig,jsconfig}*.json`, which
+// its documentSelector excludes, so a config edit can reach ttsc through no other
+// notification; before this the proxy had no arm for the method at all and the
+// sidecar's documented full-reload fallback was unreachable. A created or deleted
+// file and a config edit each reshape the root set or the compiler options, which
+// tsgo's per-file UpdateProgram cannot express, so they must drop the warm
+// Program rather than update it.
+//
+//  1. Send a `changed` event for one ordinary source file and assert the resident
+//     refresh carries exactly that URI.
+//  2. Send a tsconfig edit, a created file, and a deleted file, and assert each
+//     drops the whole Program instead.
+//  3. Send an undecodable batch (full reload) and an empty batch (no-op).
+func TestLSPWatchedFileChangesReachCompilerCaches(t *testing.T) {
+  cases := []struct {
+    name    string
+    params  string
+    wantRes [][]string
+    wantSym int
+  }{
+    {
+      name:    "changed source file is localized",
+      params:  `{"changes":[{"uri":"file:///project/src/main.ts","type":2}]}`,
+      wantRes: [][]string{{"file:///project/src/main.ts"}},
+      wantSym: 1,
+    },
+    {
+      name:    "several changed source files are localized together",
+      params:  `{"changes":[{"uri":"file:///project/a.ts","type":2},{"uri":"file:///project/b.ts","type":2}]}`,
+      wantRes: [][]string{{"file:///project/a.ts", "file:///project/b.ts"}},
+      wantSym: 1,
+    },
+    {
+      name:    "tsconfig edit drops the whole program",
+      params:  `{"changes":[{"uri":"file:///project/tsconfig.json","type":2}]}`,
+      wantRes: [][]string{{}},
+      wantSym: 1,
+    },
+    {
+      name:    "scoped tsconfig edit drops the whole program",
+      params:  `{"changes":[{"uri":"file:///project/tsconfig.build.json","type":2}]}`,
+      wantRes: [][]string{{}},
+      wantSym: 1,
+    },
+    {
+      name:    "jsconfig edit drops the whole program",
+      params:  `{"changes":[{"uri":"file:///project/jsconfig.json","type":2}]}`,
+      wantRes: [][]string{{}},
+      wantSym: 1,
+    },
+    {
+      name:    "created file drops the whole program",
+      params:  `{"changes":[{"uri":"file:///project/src/added.ts","type":1}]}`,
+      wantRes: [][]string{{}},
+      wantSym: 1,
+    },
+    {
+      name:    "deleted file drops the whole program",
+      params:  `{"changes":[{"uri":"file:///project/src/gone.ts","type":3}]}`,
+      wantRes: [][]string{{}},
+      wantSym: 1,
+    },
+    {
+      name:    "one unlocalizable entry drops the whole batch",
+      params:  `{"changes":[{"uri":"file:///project/a.ts","type":2},{"uri":"file:///project/tsconfig.json","type":2}]}`,
+      wantRes: [][]string{{}},
+      wantSym: 1,
+    },
+    {
+      name:    "a change with no type is not localizable",
+      params:  `{"changes":[{"uri":"file:///project/a.ts"}]}`,
+      wantRes: [][]string{{}},
+      wantSym: 1,
+    },
+    {
+      name:    "an undecodable batch drops the whole program",
+      params:  `{"changes":"not-an-array"}`,
+      wantRes: [][]string{{}},
+      wantSym: 1,
+    },
+    {
+      name:    "an empty batch keeps every warm program",
+      params:  `{"changes":[]}`,
+      wantRes: nil,
+      wantSym: 0,
+    },
+  }
+
+  for _, testCase := range cases {
+    t.Run(testCase.name, func(t *testing.T) {
+      plugins := &watchedFilesSource{}
+      symbols := &watchedFilesSymbolProvider{}
+      proxy := NewProxy(ProxyOptions{
+        EditorOut:      io.Discard,
+        UpstreamIn:     io.Discard,
+        Source:         plugins,
+        SymbolProvider: symbols,
+      })
+      handled, err := proxy.handleEditorEnvelope(watchedFilesEnvelope(t, testCase.params), nil)
+      if err != nil {
+        t.Fatalf("watched-file notification: %v", err)
+      }
+      if handled {
+        t.Fatal("watched-file notification was swallowed instead of forwarded to tsgo")
+      }
+      if symbols.invalidations != testCase.wantSym {
+        t.Errorf("symbol invalidations = %d, want %d", symbols.invalidations, testCase.wantSym)
+      }
+      if len(plugins.calls) != len(testCase.wantRes) {
+        t.Fatalf("resident invalidations = %v, want %v", plugins.calls, testCase.wantRes)
+      }
+      for index, want := range testCase.wantRes {
+        got := plugins.calls[index]
+        if len(got) != len(want) {
+          t.Fatalf("resident invalidation %d = %v, want %v", index, got, want)
+        }
+        for position := range want {
+          if got[position] != want[position] {
+            t.Errorf("resident invalidation %d = %v, want %v", index, got, want)
+            break
+          }
+        }
+      }
+    })
+  }
+}

package/lib/TtscCompiler.d.ts

@@ -54,7 +54,9 @@ export declare class TtscCompiler {
      * project-local caches. A user-provided `GOCACHE` is never removed. The cache
      * location comes from this instance's `cacheDir` and environment
      * (`TTSC_CACHE_DIR` / `TTSC_GO_CACHE_DIR`), defaulting to
-     * `<workspaceRoot>/node_modules/.cache/ttsc`.
+     * `<workspaceRoot>/node_modules/.cache/ttsc`. An explicit cache directory
+     * that equals or contains the project, or names a filesystem root, is
+     * rejected before any directory is removed.
      *
      * @returns Cache directories that were removed.
      */

package/lib/TtscCompiler.js

@@ -11,6 +11,7 @@ const resolveProjectConfig_1 = require("./compiler/internal/project/resolveProje
 const resolveBinary_1 = require("./compiler/internal/resolveBinary");
 const runBuild_1 = require("./compiler/internal/runBuild");
 const transformProjectInMemory_1 = require("./compiler/internal/transformProjectInMemory");
+const assertSafeExplicitCacheDirectory_1 = require("./internal/assertSafeExplicitCacheDirectory");
 const buildSourcePlugin_1 = require("./plugin/internal/buildSourcePlugin");
 const loadProjectPlugins_1 = require("./plugin/internal/loadProjectPlugins");
 /**
@@ -87,7 +88,9 @@ class TtscCompiler {
      * project-local caches. A user-provided `GOCACHE` is never removed. The cache
      * location comes from this instance's `cacheDir` and environment
      * (`TTSC_CACHE_DIR` / `TTSC_GO_CACHE_DIR`), defaulting to
-     * `<workspaceRoot>/node_modules/.cache/ttsc`.
+     * `<workspaceRoot>/node_modules/.cache/ttsc`. An explicit cache directory
+     * that equals or contains the project, or names a filesystem root, is
+     * rejected before any directory is removed.
      *
      * @returns Cache directories that were removed.
      */
@@ -99,6 +102,7 @@ class TtscCompiler {
         ];
         const explicitCacheDir = this.resolveCacheDir();
         if (explicitCacheDir !== undefined) {
+            (0, assertSafeExplicitCacheDirectory_1.assertSafeExplicitCacheDirectory)(projectRoot, explicitCacheDir);
             // An explicit constructor `cacheDir` names the cache directory for this
             // instance — exactly like `ttsc clean --cache-dir X` on the CLI — so
             // remove it wholesale plus the legacy project-local caches. This keeps

package/lib/TtscCompiler.js.map

@@ -1 +1 @@
-{"version":3,"file":"TtscCompiler.js","sourceRoot":"","sources":["../src/TtscCompiler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TtscCompiler.js","sourceRoot":"","sources":["../src/TtscCompiler.ts"],"names":[],"mappings":"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"}

package/lib/TtscService.d.ts

@@ -1,4 +1,14 @@
 import type { ITtscCompilerContext } from "./structures/ITtscCompilerContext";
+/** Construction controls for the resident transform request lifecycle. */
+export interface TtscServiceOptions {
+    /** Maximum time one transform or update request may await the host's reply. */
+    requestTimeoutMs?: number;
+}
+/** Per-call controls for a resident transform or update request. */
+export interface TtscServiceRequestOptions {
+    /** Abort this call before it receives a reply. */
+    signal?: AbortSignal;
+}
 /**
  * Resident, incremental transform service for the `ttsc` TypeScript-Go
  * pipeline.
@@ -31,7 +41,7 @@ export declare class TtscService {
      * host. The context is the same shape {@link TtscCompiler} accepts; it is not
      * replaceable per call.
      */
-    constructor(context?: ITtscCompilerContext);
+    constructor(context?: ITtscCompilerContext, options?: TtscServiceOptions);
     /**
      * Return the transformed TypeScript source for one file, or `undefined` when
      * the resident program does not contain it (for example a file excluded from
@@ -40,7 +50,7 @@ export declare class TtscService {
      * Rejects when the resident host failed to compile the project; the rejection
      * carries the host's diagnostics so callers can surface a real build error.
      */
-    transformFile(fileName: string): Promise<string | undefined>;
+    transformFile(fileName: string, options?: TtscServiceRequestOptions): Promise<string | undefined>;
     /**
      * Apply new in-memory content for one file and re-transform the project, so a
      * subsequent {@link transformFile} reflects the edit without restarting the
@@ -48,7 +58,7 @@ export declare class TtscService {
      * did not compile and the previous transform is still in effect. A relative
      * `fileName` is resolved against the project root.
      */
-    updateFile(fileName: string, content: string): Promise<boolean>;
+    updateFile(fileName: string, content: string, options?: TtscServiceRequestOptions): Promise<boolean>;
     /** Terminate the resident host and reject any in-flight requests. */
     dispose(): void;
     private absolutePath;

package/lib/TtscService.js

@@ -38,14 +38,14 @@ class TtscService {
      * host. The context is the same shape {@link TtscCompiler} accepts; it is not
      * replaceable per call.
      */
-    constructor(context = {}) {
+    constructor(context = {}, options = {}) {
         const started = (0, startResidentTransform_1.startResidentTransform)({
             ...context,
             env: context.env ? { ...context.env } : undefined,
             plugins: Array.isArray(context.plugins)
                 ? [...context.plugins]
                 : context.plugins,
-        });
+        }, options);
         this.resident = started.process;
         this.projectRoot = started.projectRoot;
     }
@@ -57,8 +57,8 @@ class TtscService {
      * Rejects when the resident host failed to compile the project; the rejection
      * carries the host's diagnostics so callers can surface a real build error.
      */
-    async transformFile(fileName) {
-        const reply = await this.resident.request({ file: this.absolutePath(fileName) }, "transform");
+    async transformFile(fileName, options = {}) {
+        const reply = await this.resident.request({ file: this.absolutePath(fileName) }, "transform", options);
         // The resident client already validated the reply shape (boolean `found`,
         // string `typescript` when found), so a malformed or wrong-shape reply
         // rejected instead of reaching here. `found: false` is the only path to
@@ -74,8 +74,8 @@ class TtscService {
      * did not compile and the previous transform is still in effect. A relative
      * `fileName` is resolved against the project root.
      */
-    async updateFile(fileName, content) {
-        const reply = await this.resident.request({ content, update: this.absolutePath(fileName) }, "update");
+    async updateFile(fileName, content, options = {}) {
+        const reply = await this.resident.request({ content, update: this.absolutePath(fileName) }, "update", options);
         // The resident client validated the reply carries a boolean `updated`, so a
         // malformed or wrong-shape reply rejected instead of collapsing to `false`.
         // `false` here means only that the edit did not compile.

package/lib/TtscService.js.map

@@ -1 +1 @@
-{"version":3,"file":"TtscService.js","sourceRoot":"","sources":["../src/TtscService.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAG7B,uFAAoF;AAGpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;IACmB,QAAQ,CAA2B;IACnC,WAAW,CAAS;IAErC;;;;OAIG;IACH,YAAmB,OAAO,GAAyB,EAAE;QACnD,MAAM,OAAO,GAAG,IAAA,+CAAsB,EAAC;YACrC,GAAG,OAAO;YACV,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;YACjD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;gBACrC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;gBACtB,CAAC,CAAC,OAAO,CAAC,OAAO;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,aAAa,CAAC,QAAgB;QACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CACvC,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EACrC,WAAW,CACZ,CAAC;QACF,0EAA0E;QAC1E,uEAAuE;QACvE,wEAAwE;QACxE,uEAAuE;QACvE,OAAO,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;YACjE,CAAC,CAAC,KAAK,CAAC,UAAU;YAClB,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,OAAe;QACvD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CACvC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAChD,QAAQ,CACT,CAAC;QACF,4EAA4E;QAC5E,4EAA4E;QAC5E,yDAAyD;QACzD,OAAO,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC;IAChC,CAAC;IAED,qEAAqE;IAC9D,OAAO;QACZ,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAEO,YAAY,CAAC,QAAgB;QACnC,OAAO,mBAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC9B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;CACF"}
+{"version":3,"file":"TtscService.js","sourceRoot":"","sources":["../src/TtscService.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAG7B,uFAAoF;AAepF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;IACmB,QAAQ,CAA2B;IACnC,WAAW,CAAS;IAErC;;;;OAIG;IACH,YACE,OAAO,GAAyB,EAAE,EAClC,OAAO,GAAuB,EAAE;QAEhC,MAAM,OAAO,GAAG,IAAA,+CAAsB,EACpC;YACE,GAAG,OAAO;YACV,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;YACjD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;gBACrC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;gBACtB,CAAC,CAAC,OAAO,CAAC,OAAO;SACpB,EACD,OAAO,CACR,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,aAAa,CACxB,QAAgB,EAChB,OAAO,GAA8B,EAAE;QAEvC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CACvC,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EACrC,WAAW,EACX,OAAO,CACR,CAAC;QACF,0EAA0E;QAC1E,uEAAuE;QACvE,wEAAwE;QACxE,uEAAuE;QACvE,OAAO,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;YACjE,CAAC,CAAC,KAAK,CAAC,UAAU;YAClB,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,UAAU,CACrB,QAAgB,EAChB,OAAe,EACf,OAAO,GAA8B,EAAE;QAEvC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CACvC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAChD,QAAQ,EACR,OAAO,CACR,CAAC;QACF,4EAA4E;QAC5E,4EAA4E;QAC5E,yDAAyD;QACzD,OAAO,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC;IAChC,CAAC;IAED,qEAAqE;IAC9D,OAAO;QACZ,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAEO,YAAY,CAAC,QAAgB;QACnC,OAAO,mBAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC9B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/lib/compiler/internal/project/readConfigJson.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Attributed JSON / JSONC readers for every configuration file ttsc owns.
+ *
+ * A bare `JSON.parse` failure reports a byte offset in an unnamed file, which
+ * is unusable exactly where attribution matters most: an `extends` chain, where
+ * any ancestor could be the source, and a watch session, which reprints the
+ * same line on every save. Every ttsc-owned configuration read goes through
+ * these helpers so the failure names its file and position in ttsc's own
+ * diagnostic voice, like the neighbouring `ttsc: extended tsconfig not found:
+ * …`.
+ *
+ * Comment, trailing-comma, and BOM removal is length-preserving (each removed
+ * character becomes a space, each removed newline stays a newline), so the line
+ * and column the JSON parser reports are the position in the file the user
+ * actually edited rather than in a shortened intermediate string.
+ */
+/**
+ * Read and parse a strict-JSON configuration file (`package.json`), naming it
+ * on failure.
+ *
+ * A leading UTF-8 BOM is accepted, matching the tsconfig reader that closed
+ * issue #216: the two readers are consulted for the same project and
+ * disagreeing about a byte order mark would only surprise the user who hit it.
+ */
+export declare function readJsonFile(file: string): unknown;
+/**
+ * Read and parse a JSONC (JSON with comments and trailing commas) configuration
+ * file — tsconfig.json, jsconfig.json — naming it on failure.
+ */
+export declare function readJsoncFile(file: string): unknown;