typescript 7.0.2 → 7.1.0-beta

package/dist/api/async/api.js

@@ -1,37 +1,124 @@
-/// <reference path="../node/node.ts" preserve="true" />
+import { CheckFlags } from "#enums/checkFlags";
 import { CompletionItemKind } from "#enums/completionItemKind";
 import { DiagnosticCategory } from "#enums/diagnosticCategory";
 import { ElementFlags } from "#enums/elementFlags";
+import { EmitOnly } from "#enums/emitOnly";
+import { IndexKind } from "#enums/indexKind";
+import { JsxEmit } from "#enums/jsxEmit";
 import { ModuleKind } from "#enums/moduleKind";
+import { ModuleResolutionKind } from "#enums/moduleResolutionKind";
+import { NewLineKind } from "#enums/newLineKind";
 import { NodeBuilderFlags } from "#enums/nodeBuilderFlags";
 import { ObjectFlags } from "#enums/objectFlags";
+import { ScriptKind } from "#enums/scriptKind";
 import { SignatureFlags } from "#enums/signatureFlags";
 import { SignatureKind } from "#enums/signatureKind";
 import { SymbolFlags } from "#enums/symbolFlags";
+import { SymbolOwnerKind } from "#enums/symbolOwnerKind";
 import { TypeFlags } from "#enums/typeFlags";
+import { TypeFormatFlags } from "#enums/typeFormatFlags";
 import { TypePredicateKind } from "#enums/typePredicateKind";
 import { ModifierFlags, unescapeLeadingUnderscores, } from "../../ast/index.js";
+import { assertNever } from "../../internal/utils.js";
 import { encodeNode, uint8ArrayToBase64, } from "../node/encoder.js";
-import { decodeNode, getNodeId, parseNodeHandle, readParseOptionsKey, readSourceFileHash, RemoteSourceFile, } from "../node/node.js";
+import { decodeNode, getNodeId, parseNodeHandleFromCompiler, readParseOptionsKey, readSourceFileHash, readSourceFileLease, RemoteNode, RemoteSourceFile, } from "../node/node.js";
 import { Wtf8Decoder } from "../node/wtf8.js";
-import { createGetCanonicalFileName, toPath, } from "../path.js";
-import { resolveFileName, toUpdateSnapshotRequest, } from "../proto.js";
-import { SourceFileCache } from "../sourceFileCache.js";
+import { canonicalize, CaseSensitivity, pathKey, toRootedDirectoryPath, toRootedPath, } from "../path.js";
+import { prepareCompilerOptions } from "../prepareCompilerOptions.generated.js";
+import { resolveFileName, validateSymbolResponse, } from "../proto.js";
+import { SourceFileCache, } from "../sourceFileCache.js";
 import { Client, } from "./client.js";
+export { formatDiagnostics, formatDiagnosticsWithColorAndContext } from "../diagnosticFormatter.js";
 export { documentURIToFileName, fileNameToDocumentURI } from "../path.js";
-export { CompletionItemKind, DiagnosticCategory, ElementFlags, ModifierFlags, ModuleKind, NodeBuilderFlags, ObjectFlags, SignatureFlags, SignatureKind, SymbolFlags, TypeFlags, TypePredicateKind };
+export { CheckFlags, CompletionItemKind, DiagnosticCategory, ElementFlags, EmitOnly, IndexKind, JsxEmit, ModifierFlags, ModuleKind, ModuleResolutionKind, NodeBuilderFlags, ObjectFlags, ScriptKind, SignatureFlags, SignatureKind, SymbolFlags, SymbolOwnerKind, TypeFlags, TypeFormatFlags, TypePredicateKind };
+let nextModuleResolutionCallbackId = 0;
+function registerModuleResolutionCallback(client, callback, getSnapshot) {
+    const name = `resolveModuleName/${++nextModuleResolutionCallbackId}`;
+    const dispose = client.registerCallback(name, params => {
+        const { moduleName, containingDirectory, resolutionMode, snapshot: snapshotId, inProgressSnapshot } = params;
+        let snapshot = snapshotId === undefined ? undefined : getSnapshot(snapshotId);
+        if (snapshotId !== undefined && snapshot === undefined) {
+            throw new Error(`Snapshot ${snapshotId} is inactive`);
+        }
+        if (inProgressSnapshot !== undefined) {
+            snapshot = -inProgressSnapshot;
+        }
+        return callback(moduleName, containingDirectory, resolutionMode, { snapshot });
+    });
+    return { name, dispose };
+}
+// @sync-only-start
+// export { all, defer, type APIRequestGenerator, type AnyAPIRequestGenerator, type AllAPIRequestGenerator, type DeferredAPIRequestGenerator, type ExecutedGeneratorsResults } from "./generatorSupport.ts";
+// import {executeRequestGenerators, type ExecutedGeneratorsResults, type AnyAPIRequestGenerator} from "./generatorSupport.ts";
+// import { sourceFileResponseToUint8Array } from "../node/encoder.ts";
+// @sync-only-end
 export class API {
+    /** @internal */
     client;
+    /** @internal */
     sourceFileCache;
     toPath;
+    decoder = new Wtf8Decoder();
+    currentDirectory;
+    caseSensitivity;
     initialized = false;
-    activeSnapshots = new Set();
-    latestSnapshot;
-    internal;
+    initializing;
+    activeSnapshots = new Map();
+    activeBuildOrchestrators = new Set();
+    activeSourceFileLeases = new Map();
+    printer;
+    debug;
     constructor(options = {}) {
         this.client = new Client(options);
         this.sourceFileCache = new SourceFileCache();
-        this.internal = new InternalAPI(this.client, () => this.ensureInitialized());
+        this.printer = new Printer(this.client);
+        this.debug = new DebugHandlers(this.client, () => this.ensureInitialized()); // @sync: this.debug = new DebugHandlers(this.client, this.ensureInitialized);
+    }
+    /**
+     * Looks up a remote declaration's binder symbol. Throws for synthesized or configuration ASTs.
+     */
+    async getSymbol(declaration) {
+        const file = getRemoteSourceFile(declaration);
+        if (!file)
+            throw new Error(`Source file not found for declaration`);
+        const record = file.symbolCache;
+        if (!record)
+            throw new Error(`Cached source file not found for declaration`);
+        const index = parseNodeHandleFromCompiler(getNodeId(declaration)).index;
+        const cached = record.symbolsByDeclarationNodeIndex.get(index);
+        if (cached)
+            return cached;
+        // @sync-only-start
+        // return this.fetchDeclarationSymbol(record, index);
+        // @sync-only-end
+        // @sync-skip-block-start
+        let request = record.declarationSymbolRequests.get(index);
+        if (!request) {
+            request = this.fetchDeclarationSymbol(record, index);
+            record.declarationSymbolRequests.set(index, request);
+        }
+        try {
+            return await request;
+        }
+        finally {
+            record.declarationSymbolRequests.delete(index);
+        }
+        // @sync-skip-block-end
+    }
+    async fetchDeclarationSymbol(record, index) {
+        const data = await this.client.apiRequest("getSymbolOfDeclaration", {
+            file: record.descriptor,
+            index,
+        });
+        validateSymbolResponse(data);
+        const reference = data.reference;
+        if (reference.kind !== SymbolOwnerKind.File) {
+            throw new Error(`Symbol ${reference.id} is not file-owned`);
+        }
+        const fileOwner = { record, api: this };
+        const symbol = this.sourceFileCache.getOrCreateSymbol(record, reference.file, reference.id, () => new Symbol(data, { kind: SymbolOwnerKind.File, owner: fileOwner }));
+        record.symbolsByDeclarationNodeIndex.set(index, symbol);
+        return symbol;
     }
     /**
      * Create an API instance from an existing LSP connection's API session.
@@ -42,56 +129,323 @@ export class API {
         await api.ensureInitialized();
         return api;
     }
+    // @sync-skip-block-start
+    batchContext() {
+        return this.client.batchContext();
+    }
+    // @sync-skip-block-end
+    // @sync-only-start
+    // batch<T extends readonly AnyAPIRequestGenerator[]>(...requestGenerators: T): ExecutedGeneratorsResults<T> {
+    //     return executeRequestGenerators(requestGenerators, requests => this.client.batchRequests(requests).responses);
+    // }
+    // @sync-only-end
     async ensureInitialized() {
-        if (!this.initialized) {
+        if (this.initialized)
+            return;
+        return this.initializing ??= this.initializeWorker();
+    }
+    async initializeWorker() {
+        try {
             const response = await this.client.apiRequest("initialize", null);
-            const getCanonicalFileName = createGetCanonicalFileName(response.useCaseSensitiveFileNames);
-            const currentDirectory = response.currentDirectory;
-            this.toPath = (fileName) => toPath(fileName, currentDirectory, getCanonicalFileName);
+            this.currentDirectory = response.currentDirectory;
+            this.caseSensitivity = response.caseSensitivity;
+            this.toPath = (fileName, basePath = response.currentDirectory) => pathKey(toRootedPath(fileName, toRootedDirectoryPath(basePath, response.currentDirectory)), response.caseSensitivity);
             this.initialized = true;
         }
+        catch (error) {
+            this.initializing = undefined;
+            throw error;
+        }
+    }
+    getCurrentDirectory() {
+        if (this.currentDirectory === undefined) {
+            throw new Error("API has not been initialized");
+        }
+        return this.currentDirectory;
+    }
+    getCanonicalFileName(fileName) {
+        return canonicalize(fileName, this.getCaseSensitivity());
+    }
+    getCaseSensitivity() {
+        if (this.caseSensitivity === undefined) {
+            throw new Error("API has not been initialized");
+        }
+        return this.caseSensitivity;
+    }
+    getNewLine() {
+        return "\n";
+    }
+    /** @internal */
+    async createBuildOrchestrator(rootNames, buildOrchestratorOptions) {
+        await this.ensureInitialized();
+        const orchestratorResponse = await this.client.apiRequest("createBuildOrchestrator", {
+            ...buildOrchestratorOptions,
+            ...buildOrchestratorOptions.overrideCompilerOptions,
+            cwd: buildOrchestratorOptions.cwd === undefined
+                ? undefined
+                : toRootedDirectoryPath(buildOrchestratorOptions.cwd, this.getCurrentDirectory()),
+            rootNames,
+        });
+        const orchestrator = new BuildOrchestrator(this.client, orchestratorResponse, () => {
+            this.activeBuildOrchestrators.delete(orchestrator);
+        });
+        this.activeBuildOrchestrators.add(orchestrator);
+        return orchestrator;
     }
     async parseConfigFile(file) {
         await this.ensureInitialized();
         return this.client.apiRequest("parseConfigFile", { file });
     }
-    async updateSnapshot(params) {
+    async parseCommandLine(commandLine) {
         await this.ensureInitialized();
-        const requestParams = toUpdateSnapshotRequest(params);
-        const data = await this.client.apiRequest("updateSnapshot", requestParams);
-        // Retain cached source files from previous snapshot for unchanged files
-        if (this.latestSnapshot) {
-            this.sourceFileCache.retainForSnapshot(data.snapshot, this.latestSnapshot.id, data.changes);
-            if (this.latestSnapshot.isDisposed()) {
-                this.sourceFileCache.releaseSnapshot(this.latestSnapshot.id);
-            }
+        return this.client.apiRequest("parseCommandLine", { commandLine });
+    }
+    async readConfigFile(file) {
+        await this.ensureInitialized();
+        return this.client.apiRequest("readConfigFile", { file });
+    }
+    async parseJsonConfigFileContent(json, options) {
+        await this.ensureInitialized();
+        return this.client.apiRequest("parseJsonConfigFileContent", { json, ...options });
+    }
+    /**
+     * Create and retain a source file independently of a program.
+     * Dispose the returned lease when the source file no longer needs to remain available remotely.
+     */
+    async createSourceFile(fileName, sourceText, options = {}) {
+        await this.ensureInitialized();
+        const data = await this.client.apiRequestBinary("createSourceFile", { fileName, sourceText, options });
+        if (!data) {
+            throw new Error("createSourceFile returned no source file");
         }
-        const snapshot = new Snapshot(data, this.client, this.sourceFileCache, this.toPath, () => {
-            this.activeSnapshots.delete(snapshot);
-            if (snapshot !== this.latestSnapshot) {
-                this.sourceFileCache.releaseSnapshot(snapshot.id);
-            }
+        return this.retainSourceFileResponse(data);
+    }
+    /**
+     * Read, create, and retain a source file independently of a program.
+     * Dispose the returned lease when the source file no longer needs to remain available remotely.
+     */
+    async createSourceFileFromFile(file, options = {}) {
+        await this.ensureInitialized();
+        const data = await this.client.apiRequestBinary("createSourceFileFromFile", { fileName: resolveFileName(file), options });
+        if (!data) {
+            throw new Error("createSourceFileFromFile returned no source file");
+        }
+        return this.retainSourceFileResponse(data);
+    }
+    /**
+     * Retain an ordinary remote source file independently of the snapshot or lease that produced it.
+     */
+    async retainSourceFile(sourceFile) {
+        await this.ensureInitialized();
+        if (!(sourceFile instanceof RemoteSourceFile)) {
+            throw new TypeError("Only remote source files can be retained");
+        }
+        const cached = this.sourceFileCache.get(sourceFile);
+        if (cached && cached !== sourceFile) {
+            throw new Error("Source file is no longer the canonical cached instance");
+        }
+        const result = await this.client.apiRequest("retainSourceFile", { file: sourceFileDescriptor(sourceFile) });
+        return this.addSourceFileLease(sourceFile, result.lease);
+    }
+    retainSourceFileResponse(data) {
+        const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+        const lease = readSourceFileLease(view);
+        try {
+            const decoded = new RemoteSourceFile(data, this.decoder, this.client.getTimingCollector(), this);
+            return this.addSourceFileLease(decoded, lease);
+        }
+        catch (error) {
+            // @sync-skip-block-start
+            void this.client.apiRequest("releaseSourceFile", { lease }).catch(() => { });
+            // @sync-skip-block-end
+            // @sync-only-start
+            // try {
+            //     this.client.apiRequest("releaseSourceFile", { lease });
+            // }
+            // catch {}
+            // @sync-only-end
+            throw error;
+        }
+    }
+    addSourceFileLease(sourceFile, lease) {
+        const cached = this.sourceFileCache.setForLease(sourceFile, lease);
+        const retained = new RetainedSourceFile(cached, lease, () => {
+            this.activeSourceFileLeases.delete(lease);
+            this.sourceFileCache.releaseLease(lease);
+        });
+        this.activeSourceFileLeases.set(lease, retained);
+        return retained;
+    }
+    async transpileModule(input, options = {}) {
+        await this.ensureInitialized();
+        return this.client.apiRequest("transpileModule", { input, options });
+    }
+    async transpileModuleFromFile(file, options = {}) {
+        await this.ensureInitialized();
+        return this.client.apiRequest("transpileModuleFromFile", { fileName: resolveFileName(file), options });
+    }
+    async transpileDeclaration(input, options = {}) {
+        await this.ensureInitialized();
+        return this.client.apiRequest("transpileDeclaration", { input, options });
+    }
+    async transpileDeclarationFromFile(file, options = {}) {
+        await this.ensureInitialized();
+        return this.client.apiRequest("transpileDeclarationFromFile", { fileName: resolveFileName(file), options });
+    }
+    async createSnapshot(params) {
+        await this.ensureInitialized();
+        const requestParams = this.prepareCreateSnapshotParams(params);
+        const data = await this.client.apiRequest("createSnapshot", requestParams);
+        const snapshot = new Snapshot(data, this.toPath, this, () => {
+            this.activeSnapshots.delete(snapshot.id);
+            this.sourceFileCache.releaseSnapshot(snapshot.id);
+        }, this.createSnapshotUpdater(() => snapshot), undefined);
+        this.activeSnapshots.set(snapshot.id, snapshot);
+        return snapshot;
+    }
+    async updateSnapshot(baseSnapshot, params) {
+        await this.ensureInitialized();
+        if (this.activeSnapshots.get(baseSnapshot.id) !== baseSnapshot || baseSnapshot.isDisposed()) {
+            throw new Error("Cannot update an inactive snapshot");
+        }
+        const data = await this.client.apiRequest("updateSnapshot", {
+            snapshot: baseSnapshot.id,
+            changes: this.prepareCreateSnapshotParams(params),
+        });
+        if (data.snapshot === baseSnapshot.id) {
+            await this.client.apiRequest("release", { snapshot: data.snapshot });
+            return baseSnapshot;
+        }
+        this.sourceFileCache.retainForSnapshot(data.snapshot, baseSnapshot.id, data.changes);
+        const snapshot = new Snapshot(data, this.toPath, this, () => {
+            this.activeSnapshots.delete(snapshot.id);
+            this.sourceFileCache.releaseSnapshot(snapshot.id);
+        }, this.createSnapshotUpdater(() => snapshot), baseSnapshot);
+        this.activeSnapshots.set(snapshot.id, snapshot);
+        return snapshot;
+    }
+    prepareCreateSnapshotParams(params) {
+        params ??= {};
+        const prepareOptions = (options) => {
+            if (!options)
+                return undefined;
+            const { moduleResolver, projectReferences, ...rest } = options;
+            moduleResolver?.ensureNotDisposed();
+            return {
+                ...rest,
+                moduleResolver: moduleResolver?.id,
+                projectReferences: projectReferences?.map(reference => ({
+                    ...reference,
+                    path: toRootedPath(reference.path, this.getCurrentDirectory()),
+                })),
+            };
+        };
+        return {
+            ...params,
+            createPrograms: params.createPrograms?.map(program => ({ ...program, options: prepareOptions(program.options) })),
+            reconfigurePrograms: params.reconfigurePrograms?.map(program => ({ ...program, options: prepareOptions(program.options) })),
+        };
+    }
+    prepareLanguageServerSnapshotChanges(changes) {
+        if (!changes)
+            return undefined;
+        const prepared = this.prepareCreateSnapshotParams(changes);
+        return prepared;
+    }
+    createSnapshotUpdater(getSnapshot) {
+        const update = params => this.updateSnapshot(getSnapshot(), params); // @sync: const update = ((params: CreateSnapshotParams) => this.updateSnapshot(getSnapshot(), params)) as SnapshotUpdater;
+        // @sync-only-start
+        // const owner = this;
+        // update.gen = function* (params: CreateSnapshotParams) { return yield* owner.updateSnapshot.gen(getSnapshot(), params); };
+        // @sync-only-end
+        return update;
+    }
+    async getCurrentLanguageServerSnapshot(...args) {
+        await this.ensureInitialized();
+        const changes = args[0];
+        const baseSnapshot = args[1];
+        if (baseSnapshot && (this.activeSnapshots.get(baseSnapshot.id) !== baseSnapshot || baseSnapshot.isDisposed())) {
+            throw new Error("Cannot use an inactive snapshot as a response base");
+        }
+        const data = await this.client.apiRequest("getCurrentLanguageServerSnapshot", {
+            baseSnapshot: baseSnapshot?.id,
+            changes: this.prepareLanguageServerSnapshotChanges(changes),
         });
-        this.latestSnapshot = snapshot;
-        this.activeSnapshots.add(snapshot);
+        if (baseSnapshot) {
+            this.sourceFileCache.retainForSnapshot(data.snapshot, baseSnapshot.id, data.changes);
+        }
+        const snapshot = new Snapshot(data, this.toPath, this, () => {
+            this.activeSnapshots.delete(snapshot.id);
+            this.sourceFileCache.releaseSnapshot(snapshot.id);
+        }, this.createSnapshotUpdater(() => snapshot), baseSnapshot);
+        this.activeSnapshots.set(snapshot.id, snapshot);
         return snapshot;
     }
+    async [globalThis.Symbol.asyncDispose]() {
+        await this.close(); // @sync: this.close();
+    }
     async close() {
-        // Dispose all active snapshots
-        for (const snapshot of [...this.activeSnapshots]) {
-            await snapshot.dispose();
+        await this.initializing?.catch(() => { }); // @sync-skip
+        try {
+            for (const retained of [...this.activeSourceFileLeases.values()]) {
+                await retained.dispose();
+            }
         }
-        // Release the latest snapshot's cache refs if still held
-        if (this.latestSnapshot) {
-            this.sourceFileCache.releaseSnapshot(this.latestSnapshot.id);
-            this.latestSnapshot = undefined;
+        finally {
+            try {
+                for (const orchestrator of [...this.activeBuildOrchestrators]) {
+                    await orchestrator.dispose();
+                }
+                for (const snapshot of [...this.activeSnapshots.values()]) {
+                    await snapshot.dispose();
+                }
+                this.sourceFileCache.clear();
+            }
+            finally {
+                await this.client.close(); // always close the underlying connection
+            }
+        }
+    }
+    async createModuleResolver(compilerOptions, options) {
+        await this.ensureInitialized();
+        const callback = options?.resolveModuleName
+            ? registerModuleResolutionCallback(this.client, options.resolveModuleName, id => this.activeSnapshots.get(id))
+            : undefined;
+        try {
+            const id = await this.client.apiRequest("createModuleResolver", {
+                compilerOptions: prepareCompilerOptions(compilerOptions, this.getCurrentDirectory()),
+                moduleResolutions: options?.moduleResolutions,
+                resolveModuleNameCallback: callback?.name,
+            });
+            return new ModuleResolver(id, this.client, callback?.dispose);
+        }
+        catch (error) {
+            callback?.dispose();
+            throw error;
         }
-        await this.client.close();
-        this.sourceFileCache.clear();
     }
     clearSourceFileCache() {
         this.sourceFileCache.clear();
     }
+    async runWithTemporaryFileUpdate(baseSnapshot, file, newText, cb) {
+        await this.ensureInitialized();
+        if (this.activeSnapshots.get(baseSnapshot.id) !== baseSnapshot || baseSnapshot.isDisposed()) {
+            throw new Error("Cannot run a temporary file update on an inactive snapshot");
+        }
+        const snapshot = await baseSnapshot.update({
+            fileSystem: {
+                kind: "layer",
+                files: { [resolveFileName(file)]: newText },
+            },
+            ensurePrograms: true,
+        });
+        try {
+            await cb(snapshot);
+        }
+        finally {
+            await snapshot.dispose();
+        }
+    }
     /**
      * Returns a snapshot of collected timing information for requests made
      * through this API instance: client-measured round-trip latency and bytes
@@ -100,8 +454,8 @@ export class API {
      *
      * Fetching the snapshot issues a lightweight request to the server to
      * retrieve its timing collection. Collection must be enabled via the
-     * `collectTiming` option; when it is not, the returned snapshot has
-     * `enabled: false` and zeroed totals.
+     * `collectTiming` option or `TS_API_TIMING_DIR` environment variable; when
+     * it is not, the returned snapshot has `enabled: false` and zeroed totals.
      */
     getTimingInfo() {
         return this.client.getTimingInfo();
@@ -110,11 +464,102 @@ export class API {
     resetTimingInfo() {
         return this.client.resetTimingInfo();
     }
+    /** Creates a program from current filesystem state. */
+    async createProgram(rootFiles, compilerOptions, createProgramOptions) {
+        await this.ensureInitialized();
+        const snapshot = await this.createSnapshot({
+            createPrograms: [{ rootFiles, compilerOptions, options: createProgramOptions }],
+        });
+        const program = snapshot.operation.createdPrograms[0];
+        if (!program) {
+            await snapshot.dispose();
+            throw new Error("createProgram did not return a project");
+        }
+        program.setOwnedSnapshot(snapshot);
+        return program;
+    }
+}
+function sourceFileDescriptor(sourceFile) {
+    return {
+        fileName: sourceFile.fileName,
+        path: sourceFile.path,
+        contentHash: sourceFile.contentHash,
+        parseOptionsKey: sourceFile.parseOptionsKey,
+        scriptKind: sourceFile.scriptKind,
+        nodeId: sourceFile.nodeId,
+    };
+}
+/** Returns whether a node is backed by a remote compiler response. */
+export function isRemoteNode(node) {
+    return node instanceof RemoteNode;
+}
+function getRemoteSourceFile(node) {
+    if (!isRemoteNode(node))
+        return undefined;
+    const file = node.getSourceFile();
+    return file instanceof RemoteSourceFile && file.api ? file : undefined;
+}
+function getNodeAPI(node) {
+    const api = getRemoteSourceFile(node)?.api;
+    if (!api)
+        return undefined;
+    if (!(api instanceof API))
+        throw new Error("Source file does not belong to the async API"); // @sync: if (!(api instanceof API)) throw new Error("Source file does not belong to the sync API");
+    return api;
+}
+/** Looks up a remote declaration's binder symbol through its API. Throws for non-remote declarations. */
+export async function getSymbol(declaration) {
+    const api = getNodeAPI(declaration);
+    if (!api)
+        throw new Error("Source file not found for declaration");
+    return api.getSymbol(declaration);
+}
+// @sync-only-start
+// export declare namespace getSymbol {
+//     function gen(declaration: Declaration): Generator<ProtocolRequest, Symbol, ProtocolResponse["result"]>;
+// }
+// getSymbol.gen = function* (declaration: Declaration): Generator<ProtocolRequest, Symbol, ProtocolResponse["result"]> {
+//     const api = getNodeAPI(declaration);
+//     if (!api) throw new Error("Source file not found for declaration");
+//     return yield* api.getSymbol.gen(declaration);
+// };
+// @sync-only-end
+/** An independently retained source file and its disposable remote-lifetime lease. */
+export class RetainedSourceFile {
+    sourceFile;
+    lease;
+    onDispose;
+    disposed = false;
+    disposePromise;
+    constructor(sourceFile, lease, onDispose) {
+        this.sourceFile = sourceFile;
+        this.lease = lease;
+        this.onDispose = onDispose;
+    }
+    [globalThis.Symbol.asyncDispose]() {
+        return this.dispose(); // @sync: this.dispose();
+    }
+    dispose() {
+        return this.disposePromise ??= this.disposeWorker();
+    }
+    async disposeWorker() {
+        if (this.disposed)
+            return;
+        const api = getNodeAPI(this.sourceFile);
+        if (!api)
+            throw new Error("Retained source file has no owning API");
+        this.disposed = true;
+        try {
+            await api.client.apiRequest("releaseSourceFile", { lease: this.lease });
+        }
+        finally {
+            this.onDispose();
+        }
+    }
 }
-export class InternalAPI {
+export class DebugHandlers {
     client;
     ensureInitialized;
-    /** @internal */
     constructor(client, ensureInitialized) {
         this.client = client;
         this.ensureInitialized = ensureInitialized;
@@ -136,32 +581,70 @@ export class InternalAPI {
 }
 export class Snapshot {
     id;
+    operation;
     projectMap;
     toPath;
-    client;
+    api;
     disposed = false;
+    disposePromise;
     onDispose;
     snapshotRegistry;
-    constructor(data, client, sourceFileCache, toPath, onDispose) {
+    projectDataMap;
+    updateSnapshot;
+    get client() {
+        return this.api.client;
+    }
+    constructor(data, toPath, api, onDispose, updateSnapshot, baseSnapshot) {
         this.id = data.snapshot;
-        this.client = client;
+        this.api = api;
         this.toPath = toPath;
         this.onDispose = onDispose;
+        this.updateSnapshot = updateSnapshot;
         this.projectMap = new Map();
-        this.snapshotRegistry = new SnapshotObjectRegistry(client, this.id, projectId => this.projectMap.get(projectId));
-        for (const projData of data.projects) {
-            const project = new Project(projData, this.id, client, sourceFileCache, toPath, this.snapshotRegistry);
-            this.projectMap.set(toPath(projData.configFileName), project);
+        const projectDataMap = new Map(baseSnapshot?.projectDataMap);
+        for (const projectId of data.changes?.removedProjects ?? []) {
+            projectDataMap.delete(projectId);
+        }
+        for (const projectData of data.projects) {
+            projectDataMap.set(projectData.id, projectData);
         }
+        this.projectDataMap = new Map([...projectDataMap].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0));
+        this.snapshotRegistry = new SnapshotObjectRegistry(this.id);
+        for (const projData of this.projectDataMap.values()) {
+            const project = new Project(projData, this.id, toPath, api, this.snapshotRegistry);
+            this.projectMap.set(projData.id, project);
+        }
+        this.operation = {
+            createdPrograms: data.operation.createdPrograms?.map(projectId => this.requireProject(projectId).program),
+            openedFiles: data.operation.openedFiles?.map(result => ({ project: this.requireProject(result.project) })),
+        };
     }
     getProjects() {
         this.ensureNotDisposed();
         return [...this.projectMap.values()];
     }
-    getProject(configFileName) {
+    getConfiguredProject(configFileName) {
         this.ensureNotDisposed();
-        return this.projectMap.get(this.toPath(configFileName));
+        const id = this.toPath(configFileName);
+        return this.projectMap.get(id);
     }
+    getProject(projectId) {
+        this.ensureNotDisposed();
+        return this.projectMap.get(projectId);
+    }
+    getProgram(projectId) {
+        return this.getProject(projectId)?.program;
+    }
+    update(params) {
+        this.ensureNotDisposed();
+        return this.updateSnapshot(params);
+    }
+    /**
+     * Gets the default project for a given file from the configured projects and
+     * inferred project already loaded in the snapshot. Synthetic projects are not
+     * considered. Files that have been opened with `openFiles` are guaranteed to
+     * have a result.
+     */
     async getDefaultProjectForFile(file) {
         this.ensureNotDisposed();
         const data = await this.client.apiRequest("getDefaultProjectForFile", {
@@ -170,12 +653,15 @@ export class Snapshot {
         });
         if (!data)
             return undefined;
-        return this.projectMap.get(this.toPath(data.configFileName));
+        return this.projectMap.get(data.id);
     }
-    [globalThis.Symbol.dispose]() {
-        this.dispose();
+    [globalThis.Symbol.asyncDispose]() {
+        return this.dispose(); // @sync: this.dispose();
     }
-    async dispose() {
+    dispose() {
+        return this.disposePromise ??= this.disposeWorker();
+    }
+    async disposeWorker() {
         if (this.disposed)
             return;
         this.disposed = true;
@@ -184,8 +670,12 @@ export class Snapshot {
         }
         this.projectMap.clear();
         this.snapshotRegistry.clear();
-        this.onDispose();
-        await this.client.apiRequest("release", { snapshot: this.id });
+        try {
+            await this.client.apiRequest("release", { snapshot: this.id });
+        }
+        finally {
+            this.onDispose();
+        }
     }
     isDisposed() {
         return this.disposed;
@@ -195,26 +685,78 @@ export class Snapshot {
             throw new Error("Snapshot is disposed");
         }
     }
+    requireProject(projectId) {
+        const project = this.projectMap.get(projectId);
+        if (!project) {
+            throw new Error(`Snapshot operation returned unknown project '${projectId}'`);
+        }
+        return project;
+    }
+}
+export class ModuleResolver {
+    id;
+    client;
+    disposeCallback;
+    disposed = false;
+    constructor(id, client, disposeCallback) {
+        this.id = id;
+        this.client = client;
+        this.disposeCallback = disposeCallback;
+    }
+    async resolveModuleName(moduleName, containingDirectory, resolutionMode, options) {
+        this.ensureNotDisposed();
+        if (options?.snapshot instanceof Snapshot && options.snapshot.isDisposed()) {
+            throw new Error("Snapshot is disposed");
+        }
+        return this.client.apiRequest("resolveModuleName", {
+            snapshot: options?.snapshot instanceof Snapshot ? options.snapshot.id : undefined,
+            inProgressSnapshot: typeof options?.snapshot === "number" ? -options.snapshot : undefined,
+            resolver: this.id,
+            moduleName,
+            containingDirectory,
+            resolutionMode,
+        });
+    }
+    [globalThis.Symbol.asyncDispose]() {
+        return this.dispose();
+    }
+    async dispose() {
+        if (this.disposed)
+            return;
+        await this.client.apiRequest("releaseModuleResolver", { resolver: this.id });
+        this.disposed = true;
+        this.disposeCallback?.();
+    }
+    /** @internal */
+    ensureNotDisposed() {
+        if (this.disposed)
+            throw new Error("ModuleResolver is disposed");
+    }
 }
 class SnapshotObjectRegistry {
     symbols = new Map();
-    client;
+    projectRegistries = new Map();
     snapshotId;
-    resolveProject;
-    constructor(client, snapshotId, resolveProject) {
-        this.client = client;
+    constructor(snapshotId) {
         this.snapshotId = snapshotId;
-        this.resolveProject = resolveProject;
     }
-    /** Resolve a project id (a config file path) to its Project within this snapshot. */
-    getProject(projectId) {
-        return this.resolveProject(projectId);
+    addProjectRegistry(registry) {
+        this.projectRegistries.set(registry.project.id, registry);
     }
     getOrCreateSymbol(data) {
-        let symbol = this.symbols.get(data.id);
+        const reference = data.reference;
+        if (reference.kind !== SymbolOwnerKind.Snapshot)
+            throw new Error(`Symbol ${reference.id} is not snapshot-owned`);
+        let symbol = this.symbols.get(reference.id);
         if (!symbol) {
-            symbol = new Symbol(data, this);
-            this.symbols.set(data.id, symbol);
+            if (reference.snapshot !== this.snapshotId) {
+                throw new Error(`Symbol ${reference.id} belongs to snapshot ${reference.snapshot}, not ${this.snapshotId}`);
+            }
+            const registry = this.projectRegistries.get(reference.project);
+            if (!registry)
+                throw new Error(`Symbol ${reference.id} references unknown project '${reference.project}'`);
+            symbol = new Symbol(data, { kind: SymbolOwnerKind.Snapshot, registry });
+            this.symbols.set(reference.id, symbol);
         }
         return symbol;
     }
@@ -224,65 +766,51 @@ class SnapshotObjectRegistry {
     clear() {
         this.symbols.clear();
     }
-    async fetchSymbol(source, method, handle, projectId) {
-        if (!handle)
-            return undefined;
-        const cached = this.getSymbol(handle);
-        if (cached)
-            return cached;
-        const data = await this.client.apiRequest(method, {
-            snapshot: this.snapshotId,
-            project: projectId,
-            objectId: source.id,
-        });
-        if (!data)
-            throw new Error(`${method} returned null symbol for ${source.constructor.name} ${source.id}`);
-        return this.getOrCreateSymbol(data);
-    }
-    async fetchSymbols(source, method, handles, projectId) {
-        if (handles) {
-            const result = new Array(handles.length);
-            let allCached = true;
-            for (let i = 0; i < handles.length; i++) {
-                const cached = this.getSymbol(handles[i]);
-                if (!cached) {
-                    allCached = false;
-                    break;
-                }
-                result[i] = cached;
-            }
-            if (allCached)
-                return result;
-        }
-        const symbolData = await this.client.apiRequest(method, {
-            snapshot: this.snapshotId,
-            project: projectId,
-            objectId: source.id,
-        });
-        if (symbolData == null)
-            return [];
-        else
-            return symbolData.map(data => this.getOrCreateSymbol(data));
-    }
 }
 class ProjectObjectRegistry {
-    client;
     snapshotId;
     project;
     snapshotRegistry;
     types = new Map();
     signatures = new Map();
-    constructor(client, snapshotId, project, snapshotRegistry) {
-        this.client = client;
+    disposed = false;
+    get client() {
+        return this.project.api.client;
+    }
+    get sourceFileCache() {
+        return this.project.api.sourceFileCache;
+    }
+    constructor(snapshotId, project, snapshotRegistry) {
         this.snapshotId = snapshotId;
         this.project = project;
         this.snapshotRegistry = snapshotRegistry;
+        snapshotRegistry.addProjectRegistry(this);
     }
     getOrCreateSymbol(data) {
-        return this.snapshotRegistry.getOrCreateSymbol(data);
+        this.ensureNotDisposed();
+        validateSymbolResponse(data);
+        const reference = data.reference;
+        if (reference.kind === SymbolOwnerKind.Snapshot) {
+            return this.snapshotRegistry.getOrCreateSymbol(data);
+        }
+        const record = this.sourceFileCache.getOrCreateRecord(reference.file, this.snapshotId, this.project.id);
+        return this.sourceFileCache.getOrCreateSymbol(record, reference.file, reference.id, () => new Symbol(data, {
+            kind: SymbolOwnerKind.File,
+            owner: { record, api: this.project.api },
+        }));
     }
-    getSymbol(id) {
-        return this.snapshotRegistry.getSymbol(id);
+    /** Find an already-interned symbol and retain its file record for this registry. */
+    getCachedSymbol(reference) {
+        this.ensureNotDisposed();
+        if (reference.file === undefined) {
+            return this.snapshotRegistry.getSymbol(reference.id);
+        }
+        const record = this.sourceFileCache.findRecord(reference.file);
+        const symbol = record?.symbolsById.get(reference.id);
+        if (record && symbol) {
+            this.sourceFileCache.retainRecord(record, this.snapshotId, this.project.id);
+        }
+        return symbol;
     }
     getOrCreateType(data) {
         let type = this.types.get(data.id);
@@ -295,6 +823,9 @@ class ProjectObjectRegistry {
     getType(id) {
         return this.types.get(id);
     }
+    createNodeHandle(handle) {
+        return new NodeHandle(handle, this.project);
+    }
     getOrCreateSignature(data) {
         let sig = this.signatures.get(data.id);
         if (!sig) {
@@ -307,10 +838,15 @@ class ProjectObjectRegistry {
         return this.signatures.get(id);
     }
     clear() {
+        this.disposed = true;
         this.types.clear();
         this.signatures.clear();
     }
-    async fetchType(source, method, handle) {
+    ensureNotDisposed() {
+        if (this.disposed)
+            throw new Error("Project object registry is disposed");
+    }
+    async fetchOptionalType(source, method, handle) {
         if (handle !== false) {
             if (!handle)
                 return undefined;
@@ -324,11 +860,31 @@ class ProjectObjectRegistry {
             objectId: source.id,
         });
         if (!data)
-            throw new Error(`${method} returned null type for ${source.constructor.name} ${source.id}`);
+            return undefined;
         return this.getOrCreateType(data);
     }
-    async fetchSymbol(source, method, handle) {
-        return this.snapshotRegistry.fetchSymbol(source, method, handle, this.project.id);
+    async fetchType(source, method, handle) {
+        const result = await this.fetchOptionalType(source, method, handle);
+        if (result === undefined)
+            throw new Error(`${method} returned no type for ${source.constructor.name} ${source.id}`);
+        return result;
+    }
+    async fetchSymbol(source, method, reference) {
+        if (!reference)
+            return undefined;
+        const cached = this.getCachedSymbol(reference);
+        if (cached)
+            return cached;
+        const data = source instanceof Symbol
+            ? await this.client.apiRequest(method, { symbol: source.reference })
+            : await this.client.apiRequest(method, {
+                snapshot: this.snapshotId,
+                project: this.project.id,
+                objectId: source.id,
+            });
+        if (!data)
+            throw new Error(`${method} returned null symbol for ${source.constructor.name} ${source.id}`);
+        return this.getOrCreateSymbol(data);
     }
     async fetchSignature(source, method, handle) {
         if (!handle)
@@ -370,8 +926,29 @@ class ProjectObjectRegistry {
         else
             return typesData.map(data => this.getOrCreateType(data));
     }
-    async fetchSymbols(source, method, handles) {
-        return this.snapshotRegistry.fetchSymbols(source, method, handles, this.project.id);
+    async fetchSymbols(source, method, references) {
+        if (references) {
+            const result = new Array(references.length);
+            for (let i = 0; i < references.length; i++) {
+                const cached = this.getCachedSymbol(references[i]);
+                if (!cached) {
+                    return this.fetchSymbolsFromServer(source, method);
+                }
+                result[i] = cached;
+            }
+            return result;
+        }
+        return this.fetchSymbolsFromServer(source, method);
+    }
+    async fetchSymbolsFromServer(source, method) {
+        const data = source instanceof Symbol
+            ? await this.client.apiRequest(method, { symbol: source.reference })
+            : await this.client.apiRequest(method, {
+                snapshot: this.snapshotId,
+                project: this.project.id,
+                objectId: source.id,
+            });
+        return data?.map(symbol => this.getOrCreateSymbol(symbol)) ?? [];
     }
     // getBaseTypes is a checker-level endpoint keyed by `type` (not `objectId`),
     // so it cannot go through fetchTypes. This helper reuses that server method.
@@ -385,52 +962,274 @@ class ProjectObjectRegistry {
             return [];
         return typesData.map(data => this.getOrCreateType(data));
     }
-}
-export class Project {
-    id;
-    configFileName;
-    compilerOptions;
-    rootFiles;
-    program;
-    checker;
-    emitter;
-    client;
-    constructor(data, snapshotId, client, sourceFileCache, toPath, snapshotRegistry) {
-        this.id = data.id;
+    async fetchPropertiesOfType(source) {
+        const data = await this.client.apiRequest("getPropertiesOfType", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            type: source.id,
+        });
+        return data ? data.map(symbol => this.getOrCreateSymbol(symbol)) : [];
+    }
+    async fetchApparentPropertiesOfType(source) {
+        const data = await this.client.apiRequest("getApparentPropertiesOfType", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            objectId: source.id,
+        });
+        return data ? data.map(symbol => this.getOrCreateSymbol(symbol)) : [];
+    }
+    async fetchPropertyOfType(source, name) {
+        const data = await this.client.apiRequest("getPropertyOfType", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            type: source.id,
+            name,
+        });
+        return data ? this.getOrCreateSymbol(data) : undefined;
+    }
+    async fetchSignaturesOfType(source, kind) {
+        const data = await this.client.apiRequest("getSignaturesOfType", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            type: source.id,
+            kind,
+        });
+        return data.map(signature => this.getOrCreateSignature(signature));
+    }
+    async fetchIndexInfosOfType(source) {
+        const data = await this.client.apiRequest("getIndexInfosOfType", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            type: source.id,
+        });
+        if (!data)
+            return [];
+        return data.map(info => ({
+            keyType: this.getOrCreateType(info.keyType),
+            valueType: this.getOrCreateType(info.valueType),
+            isReadonly: info.isReadonly ?? false,
+            declaration: info.declaration ? new NodeHandle(info.declaration, this.project) : undefined,
+        }));
+    }
+    async fetchTypeParameterAtPosition(source, pos) {
+        const data = await this.client.apiRequest("getTypeParameterAtPosition", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            signature: source.id,
+            index: pos,
+        });
+        return this.getOrCreateType(data);
+    }
+}
+export class Project {
+    /** @internal */
+    api;
+    id;
+    configFileName;
+    currentDirectory;
+    dirty;
+    parsedCommandLine;
+    program;
+    checker;
+    languageService;
+    constructor(data, snapshotId, toPath, api, snapshotRegistry) {
+        this.id = data.id;
+        this.api = api;
         this.configFileName = data.configFileName;
-        this.compilerOptions = data.compilerOptions;
-        this.rootFiles = data.rootFiles;
-        this.client = client;
-        this.program = new Program(snapshotId, this, client, sourceFileCache, toPath);
-        const objectRegistry = new ProjectObjectRegistry(client, snapshotId, this, snapshotRegistry);
-        this.checker = new Checker(snapshotId, this, client, objectRegistry);
-        this.emitter = new Emitter(client);
+        this.currentDirectory = data.currentDirectory;
+        this.dirty = data.dirty;
+        if (!data.parsedCommandLine?.options) {
+            throw new Error(`Project '${data.configFileName}' has no parsed command line`);
+        }
+        this.parsedCommandLine = data.parsedCommandLine;
+        this.program = new Program(snapshotId, this, toPath);
+        const objectRegistry = new ProjectObjectRegistry(snapshotId, this, snapshotRegistry);
+        this.checker = new Checker(snapshotId, this, objectRegistry);
+        this.languageService = new LanguageService(snapshotId, this, objectRegistry);
     }
     dispose() {
         this.checker.dispose();
     }
 }
+export class LanguageService {
+    snapshotId;
+    project;
+    objectRegistry;
+    get client() {
+        return this.project.api.client;
+    }
+    constructor(snapshotId, project, objectRegistry) {
+        this.snapshotId = snapshotId;
+        this.project = project;
+        this.objectRegistry = objectRegistry;
+    }
+    async getImportAdderEdits(file, actions) {
+        const requestActions = actions.map(action => {
+            switch (action.kind) {
+                case "importSymbol":
+                    const importSymbolAction = {
+                        kind: "importSymbol",
+                        symbol: action.symbol.reference,
+                    };
+                    if (action.isValidTypeOnlyUseSite !== undefined) {
+                        importSymbolAction.isValidTypeOnlyUseSite = action.isValidTypeOnlyUseSite;
+                    }
+                    return importSymbolAction;
+                default:
+                    return assertNever(action.kind);
+            }
+        });
+        const data = await this.client.apiRequest("getImportAdderEdits", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            file,
+            actions: requestActions,
+        });
+        return data ?? [];
+    }
+    async getImportEditsForSymbols(file, symbols, options = {}) {
+        return this.getImportAdderEdits(file, symbols.map((symbol) => {
+            if (options.isValidTypeOnlyUseSite !== undefined) {
+                return {
+                    kind: "importSymbol",
+                    symbol,
+                    isValidTypeOnlyUseSite: options.isValidTypeOnlyUseSite,
+                };
+            }
+            return {
+                kind: "importSymbol",
+                symbol,
+            };
+        }));
+    }
+    async getReferencedSymbolsForNode(node, position) {
+        const data = await this.client.apiRequest("getReferencedSymbolsForNode", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            node: getNodeId(node),
+            position,
+        });
+        return (data ?? []).map(entry => ({
+            definition: new NodeHandle(entry.definition, this.project),
+            symbol: entry.symbol ? this.objectRegistry.getOrCreateSymbol(entry.symbol) : undefined,
+            references: (entry.references ?? []).map(h => new NodeHandle(h, this.project)),
+        }));
+    }
+    async getSignatureUsage(signatureDecl) {
+        const data = await this.client.apiRequest("getSignatureUsages", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            signatureDecl: getNodeId(signatureDecl),
+        });
+        return (data ?? []).map(entry => ({
+            name: new NodeHandle(entry.name, this.project),
+            call: entry.call ? new NodeHandle(entry.call, this.project) : undefined,
+        }));
+    }
+    async getCompletionsAtPosition(document, position, options) {
+        const data = await this.client.apiRequest("getCompletionsAtPosition", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            file: document,
+            position,
+            triggerCharacter: options?.triggerCharacter,
+            includeSymbol: options?.includeSymbol,
+        });
+        if (!data)
+            return undefined;
+        return {
+            isIncomplete: data.isIncomplete,
+            entries: data.entries.map(e => ({
+                ...e,
+                symbol: e.symbol ? this.objectRegistry.getOrCreateSymbol(e.symbol) : undefined,
+            })),
+        };
+    }
+    /**
+     * Format a synthesized node with the correct indentation for insertion at a
+     * specific position in an existing source file.
+     *
+     * @param node The synthesized AST node to format.
+     * @param file The target file where the node will be inserted.
+     * @param position The UTF-16 code-unit offset in the target file for insertion.
+     * @returns The formatted text of the node, indented for the insertion position.
+     */
+    async formatNodeForInsertion(node, file, position) {
+        const encoded = encodeNode(node);
+        const base64 = uint8ArrayToBase64(encoded);
+        return this.client.apiRequest("formatNodeForInsertion", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            file,
+            position,
+            data: base64,
+        });
+    }
+}
 export class Program {
+    /** @internal */
     snapshotId;
+    id;
     project;
-    client;
-    sourceFileCache;
     toPath;
     decoder = new Wtf8Decoder();
     sourceFileMetadataCache = new Map();
-    constructor(snapshotId, project, client, sourceFileCache, toPath) {
+    ownedSnapshot;
+    disposePromise;
+    get client() {
+        return this.project.api.client;
+    }
+    get sourceFileCache() {
+        return this.project.api.sourceFileCache;
+    }
+    constructor(snapshotId, project, toPath) {
         this.snapshotId = snapshotId;
+        this.id = project.id;
         this.project = project;
-        this.client = client;
-        this.sourceFileCache = sourceFileCache;
         this.toPath = toPath;
     }
+    getCurrentDirectory() {
+        return this.project.currentDirectory;
+    }
+    getCanonicalFileName(fileName) {
+        return this.project.api.getCanonicalFileName(fileName);
+    }
+    getNewLine() {
+        return this.project.parsedCommandLine.options.newLine === NewLineKind.CRLF ? "\r\n" : "\n";
+    }
+    /** @internal */
+    setOwnedSnapshot(snapshot) {
+        this.ownedSnapshot = snapshot;
+    }
+    [globalThis.Symbol.asyncDispose]() {
+        return this.dispose(); // @sync: this.dispose();
+    }
+    dispose() {
+        return this.disposePromise ??= this.disposeWorker();
+    }
+    async disposeWorker() {
+        const snapshot = this.ownedSnapshot;
+        this.ownedSnapshot = undefined;
+        if (snapshot)
+            await snapshot.dispose();
+    }
     getCompilerOptions() {
-        return this.project.compilerOptions;
+        return this.project.parsedCommandLine.options;
     }
     async getSourceFile(file) {
         const fileName = resolveFileName(file);
-        const path = this.toPath(fileName);
+        const path = this.pathKeyForFileName(fileName);
+        return this.getSourceFileWorker(file, path);
+    }
+    /**
+     * Returns the source file for an already-canonical path.
+     */
+    getSourceFileByPath(path) {
+        // The wire format is a string, but the cache key remains the supplied
+        // PathKey and is never treated as a RootedPath.
+        return this.getSourceFileWorker(path, path);
+    }
+    async getSourceFileWorker(file, path) {
         // Check if we already have a retained cache entry for this (snapshot, project) pair
         const retained = this.sourceFileCache.getRetained(path, this.snapshotId, this.project.id);
         if (retained) {
@@ -445,12 +1244,64 @@ export class Program {
         if (!binaryData) {
             return undefined;
         }
-        const view = new DataView(binaryData.buffer, binaryData.byteOffset, binaryData.byteLength);
-        const contentHash = readSourceFileHash(view);
-        const parseOptionsKey = readParseOptionsKey(view);
         // Create a new RemoteSourceFile and cache it (set returns existing if hash matches)
-        const sourceFile = new RemoteSourceFile(binaryData, this.decoder, this.client.getTimingCollector());
-        return this.sourceFileCache.set(path, sourceFile, parseOptionsKey, contentHash, this.snapshotId, this.project.id);
+        const decoded = new RemoteSourceFile(binaryData, this.decoder, this.client.getTimingCollector(), this.project.api);
+        return this.sourceFileCache.set(decoded, this.snapshotId, this.project.id);
+    }
+    async getResolvedModule(file, moduleName, mode) {
+        const result = await this.client.apiRequest("getResolvedModule", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            file,
+            moduleName,
+            mode,
+        });
+        return result ?? undefined;
+    }
+    async getModeForUsageLocation(file, usage) {
+        return this.client.apiRequest("getModeForUsageLocation", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            file,
+            usage: getNodeId(usage),
+        });
+    }
+    async getModeForResolutionAtIndex(file, index) {
+        return this.client.apiRequest("getModeForResolutionAtIndex", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            file,
+            index,
+        });
+    }
+    async getResolvedModuleFromModuleSpecifier(moduleSpecifier, sourceFile) {
+        const result = await this.client.apiRequest("getResolvedModuleFromModuleSpecifier", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            moduleSpecifier: getNodeId(moduleSpecifier),
+            sourceFile,
+        });
+        return result ?? undefined;
+    }
+    async getResolvedTypeReferenceDirective(file, typeDirectiveName, mode) {
+        const result = await this.client.apiRequest("getResolvedTypeReferenceDirective", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            file,
+            typeDirectiveName,
+            mode,
+        });
+        return result ?? undefined;
+    }
+    async getResolvedTypeReferenceDirectiveFromTypeReferenceDirective(typeReferenceDirective, sourceFile) {
+        const result = await this.client.apiRequest("getResolvedTypeReferenceDirectiveFromTypeReferenceDirective", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            sourceFile,
+            typeDirectiveName: typeReferenceDirective.fileName,
+            resolutionMode: typeReferenceDirective.resolutionMode,
+        });
+        return result ?? undefined;
     }
     async getSourceFileNames() {
         const data = await this.client.apiRequest("getSourceFileNames", {
@@ -464,8 +1315,8 @@ export class Program {
      * is not part of the program. Metadata is fetched lazily per file and cached on this
      * `Program` instance.
      */
-    getSourceFileMetadata(fileName) {
-        return this.getSourceFileMetadataByPath(this.toPath(fileName));
+    getSourceFileMetadata(file) {
+        return this.getSourceFileMetadataByPath(this.pathKeyForFileName(resolveFileName(file)));
     }
     /**
      * Returns program-stored metadata for the source file at the given path, or `undefined`
@@ -482,6 +1333,8 @@ export class Program {
         return metadata;
     }
     async fetchSourceFileMetadata(path) {
+        // PathKey is serialized as a string; the server deliberately treats all
+        // client-provided path text as untrusted input.
         const data = await this.client.apiRequest("getSourceFileMetadata", {
             snapshot: this.snapshotId,
             project: this.project.id,
@@ -489,6 +1342,9 @@ export class Program {
         });
         return data ?? undefined;
     }
+    pathKeyForFileName(fileName) {
+        return this.toPath(fileName, this.project.currentDirectory);
+    }
     /**
      * Returns whether the given source file was loaded as part of an external library
      * (e.g. a dependency resolved from `node_modules`). The underlying program metadata is
@@ -508,62 +1364,103 @@ export class Program {
         return metadata?.isDefaultLibrary ?? false;
     }
     /**
-     * Get syntactic (parse) diagnostics for a specific file or all files.
-     * @param file - Optional file to get diagnostics for. If omitted, returns diagnostics for all files.
+     * Get all config source file names associated with this program's project config.
+     * Includes the root config file and any extended config files.
+     */
+    async getConfigFileNames() {
+        const data = await this.client.apiRequest("getConfigFileNames", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+        });
+        return data ?? [];
+    }
+    /**
+     * Get a config source file by file name/URI.
+     * This can return the project's root tsconfig file or one of its extended config files.
+     */
+    async getConfigSourceFile(file) {
+        const binaryData = await this.client.apiRequestBinary("getConfigSourceFile", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            file,
+        });
+        if (!binaryData) {
+            return undefined;
+        }
+        return new RemoteSourceFile(binaryData, this.decoder, undefined, this.project.api);
+    }
+    /**
+     * Get syntactic (parse) diagnostics for specific files or all files.
+     * @param file - Optional file(s) to get diagnostics for. If omitted, returns diagnostics for all files.
      */
     async getSyntacticDiagnostics(file) {
+        const files = file === undefined ? undefined
+            : Array.isArray(file) ? file
+                : [file];
         const data = await this.client.apiRequest("getSyntacticDiagnostics", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            ...(file !== undefined ? { file } : {}),
+            files,
         });
         return data ?? [];
     }
     /**
-     * Get binder diagnostics for a specific file or all files.
-     * @param file - Optional file to get diagnostics for. If omitted, returns diagnostics for all files.
+     * Get binder diagnostics for specific files or all files.
+     * @param file - Optional file(s) to get diagnostics for. If omitted, returns diagnostics for all files.
      */
     async getBindDiagnostics(file) {
+        const files = file === undefined ? undefined
+            : Array.isArray(file) ? file
+                : [file];
         const data = await this.client.apiRequest("getBindDiagnostics", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            ...(file !== undefined ? { file } : {}),
+            files,
         });
         return data ?? [];
     }
     /**
-     * Get semantic (type-check) diagnostics for a specific file or all files.
-     * @param file - Optional file to get diagnostics for. If omitted, returns diagnostics for all files.
+     * Get semantic (type-check) diagnostics for specific files or all files.
+     * @param file - Optional file(s) to get diagnostics for. If omitted, returns diagnostics for all files.
      */
     async getSemanticDiagnostics(file) {
+        const files = file === undefined ? undefined
+            : Array.isArray(file) ? file
+                : [file];
         const data = await this.client.apiRequest("getSemanticDiagnostics", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            ...(file !== undefined ? { file } : {}),
+            files,
         });
         return data ?? [];
     }
     /**
-     * Get suggestion diagnostics for a specific file or all files.
-     * @param file - Optional file to get diagnostics for. If omitted, returns diagnostics for all files.
+     * Get suggestion diagnostics for specific files or all files.
+     * @param file - Optional file(s) to get diagnostics for. If omitted, returns diagnostics for all files.
      */
     async getSuggestionDiagnostics(file) {
+        const files = file === undefined ? undefined
+            : Array.isArray(file) ? file
+                : [file];
         const data = await this.client.apiRequest("getSuggestionDiagnostics", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            ...(file !== undefined ? { file } : {}),
+            files,
         });
         return data ?? [];
     }
     /**
-     * Get declaration emit diagnostics for a specific file or all files.
-     * @param file - Optional file to get diagnostics for. If omitted, returns diagnostics for all files.
+     * Get declaration emit diagnostics for specific files or all files.
+     * @param file - Optional file(s) to get diagnostics for. If omitted, returns diagnostics for all files.
      */
     async getDeclarationDiagnostics(file) {
+        const files = file === undefined ? undefined
+            : Array.isArray(file) ? file
+                : [file];
         const data = await this.client.apiRequest("getDeclarationDiagnostics", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            ...(file !== undefined ? { file } : {}),
+            files,
         });
         return data ?? [];
     }
@@ -597,22 +1494,206 @@ export class Program {
         });
         return data ?? [];
     }
+    /**
+     * Emits files to the configured filesystem. Layer and host filesystems are
+     * written through; full filesystems remain immutable and return emitted
+     * files in {@link EmitResult.fileSystem}.
+     */
+    async emit(emitOnly) {
+        const response = await this.client.apiRequest("emit", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            emitOnly,
+        });
+        const fileSystem = response.emittedFilesContents.length
+            ? {
+                kind: "layer",
+                files: Object.fromEntries(response.emittedFiles.map((fileName, index) => [fileName, response.emittedFilesContents[index]])),
+            }
+            : undefined;
+        return {
+            emitSkipped: response.emitSkipped,
+            diagnostics: response.diagnostics,
+            emittedFiles: response.emittedFiles,
+            fileSystem,
+        };
+    }
+    /**
+     * Emits files and returns their contents without writing to the filesystem.
+     */
+    async emitToString(emitOnly) {
+        const response = await this.client.apiRequest("emitToString", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            emitOnly,
+        });
+        return toEmitOutput(response);
+    }
+    /**
+     * Gets JavaScript output for selected files regardless of project `noEmit`, `emitDeclarationOnly`, and `noEmitOnError` settings.
+     */
+    async getJavaScriptEmit(files) {
+        const response = await this.client.apiRequest("getJavaScriptEmit", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            files,
+        });
+        return toEmitOutput(response);
+    }
+    /**
+     * Gets declaration output for selected files regardless of project `noEmit`, `declaration`, `emitDeclarationOnly`, and `noEmitOnError` settings.
+     */
+    async getDeclarationEmit(files) {
+        const response = await this.client.apiRequest("getDeclarationEmit", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            files,
+        });
+        return toEmitOutput(response);
+    }
+    getProject() {
+        return this.project;
+    }
+}
+export class BuildOrchestrator {
+    client;
+    id;
+    disposed = false;
+    disposePromise;
+    onDispose;
+    constructor(client, orchestratorResponse, onDispose) {
+        this.client = client;
+        this.id = orchestratorResponse.buildOrchestratorID;
+        this.onDispose = onDispose;
+    }
+    [globalThis.Symbol.asyncDispose]() {
+        return this.dispose(); // @sync: this.dispose();
+    }
+    dispose() {
+        return this.disposePromise ??= this.disposeWorker();
+    }
+    async disposeWorker() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        try {
+            await this.client.apiRequest("disposeBuildOrchestrator", {
+                buildOrchestratorID: this.id,
+            });
+        }
+        finally {
+            this.onDispose();
+        }
+    }
+    async build(project) {
+        this.ensureNotDisposed();
+        const response = await this.client.apiRequest("build", {
+            buildOrchestratorID: this.id,
+            ...(project !== undefined ? { project } : {}),
+        });
+        return response;
+    }
+    async buildReferences(project) {
+        this.ensureNotDisposed();
+        const response = await this.client.apiRequest("buildReferences", {
+            buildOrchestratorID: this.id,
+            project,
+        });
+        return response;
+    }
+    async clean(project) {
+        this.ensureNotDisposed();
+        const response = await this.client.apiRequest("cleanBuild", {
+            buildOrchestratorID: this.id,
+            ...(project !== undefined ? { project } : {}),
+        });
+        return response;
+    }
+    async cleanReferences(project) {
+        this.ensureNotDisposed();
+        const response = await this.client.apiRequest("cleanReferences", {
+            buildOrchestratorID: this.id,
+            ...(project !== undefined ? { project } : {}),
+        });
+        return response;
+    }
+    isDisposed() {
+        return this.disposed;
+    }
+    ensureNotDisposed() {
+        if (this.disposed) {
+            throw new Error("Build orchestrator is disposed");
+        }
+    }
+}
+function toEmitOutput(response) {
+    const outputFiles = new Map();
+    for (const { fileName, ...outputFile } of response.outputFiles) {
+        outputFiles.set(fileName, outputFile);
+    }
+    return {
+        emitSkipped: response.emitSkipped,
+        diagnostics: response.diagnostics,
+        outputFiles,
+    };
 }
 export class Checker {
     snapshotId;
     project;
-    client;
     objectRegistry;
     wellKnownSymbols;
-    constructor(snapshotId, project, client, objectRegistry) {
+    wellKnownSignatures;
+    get client() {
+        return this.project.api.client;
+    }
+    constructor(snapshotId, project, objectRegistry) {
         this.snapshotId = snapshotId;
         this.project = project;
-        this.client = client;
         this.objectRegistry = objectRegistry;
     }
     dispose() {
         this.objectRegistry.clear();
     }
+    /** Get the merged symbol, or the original symbol if it has not been merged. */
+    async getMergedSymbol(symbol) {
+        const data = await this.client.apiRequest("getMergedSymbol", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            symbol: symbol.reference,
+        });
+        return this.objectRegistry.getOrCreateSymbol(data);
+    }
+    /**
+     * Get a node's merged symbol. For a declaration, prefer
+     * {@link Checker.getSymbolOfDeclaration} for a non-nullable result.
+     */
+    async getSymbolOfNode(node) {
+        const data = await this.client.apiRequest("getSymbolOfNode", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            location: getNodeId(node),
+        });
+        return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
+    }
+    /** Get a declaration's merged symbol. */
+    async getSymbolOfDeclaration(node) {
+        const data = await this.client.apiRequest("getSymbolOfDeclarationForChecker", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            location: getNodeId(node),
+        });
+        // Declarations normally have symbols, but preserve unexpected null results at runtime.
+        return (data && this.objectRegistry.getOrCreateSymbol(data));
+    }
+    /** Get a symbol's merged parent, if any. */
+    async getParentOfSymbol(symbol) {
+        const data = await this.client.apiRequest("getParentOfSymbolForChecker", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            symbol: symbol.reference,
+        });
+        return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
+    }
     async getSymbolAtLocation(nodeOrNodes) {
         if (Array.isArray(nodeOrNodes)) {
             const data = await this.client.apiRequest("getSymbolsAtLocations", {
@@ -647,21 +1728,37 @@ export class Checker {
         });
         return data.map(d => d ? this.objectRegistry.getOrCreateSymbol(d) : undefined);
     }
+    async getSymbolOfSourceFile(fileOrFiles) {
+        if (Array.isArray(fileOrFiles)) {
+            const data = await this.client.apiRequest("getSymbolsOfSourceFiles", {
+                snapshot: this.snapshotId,
+                project: this.project.id,
+                files: fileOrFiles,
+            });
+            return data.map(d => d ? this.objectRegistry.getOrCreateSymbol(d) : undefined);
+        }
+        const data = await this.client.apiRequest("getSymbolOfSourceFile", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            file: fileOrFiles,
+        });
+        return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
+    }
     async getTypeOfSymbol(symbolOrSymbols) {
         if (Array.isArray(symbolOrSymbols)) {
             const data = await this.client.apiRequest("getTypesOfSymbols", {
                 snapshot: this.snapshotId,
                 project: this.project.id,
-                symbols: symbolOrSymbols.map(s => s.id),
+                symbols: symbolOrSymbols.map(symbol => symbol.reference),
             });
-            return data.map(d => d ? this.objectRegistry.getOrCreateType(d) : undefined);
+            return data.map(d => this.objectRegistry.getOrCreateType(d));
         }
         const data = await this.client.apiRequest("getTypeOfSymbol", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            symbol: symbolOrSymbols.id,
+            symbol: symbolOrSymbols.reference,
         });
-        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
+        return this.objectRegistry.getOrCreateType(data);
     }
     /**
      * Get the declared type of a symbol. Always returns a type; for symbols whose
@@ -672,63 +1769,32 @@ export class Checker {
         const data = await this.client.apiRequest("getDeclaredTypeOfSymbol", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            symbol: symbol.id,
+            symbol: symbol.reference,
         });
-        if (!data)
-            throw new Error(`getDeclaredTypeOfSymbol returned no type for symbol ${symbol.id}`);
         return this.objectRegistry.getOrCreateType(data);
     }
-    async getReferencesToSymbolInFile(file, symbol) {
-        const data = await this.client.apiRequest("getReferencesToSymbolInFile", {
-            snapshot: this.snapshotId,
-            project: this.project.id,
-            file,
-            symbol: symbol.id,
-        });
-        return (data ?? []).map(h => new NodeHandle(h, this.project));
-    }
-    async getReferencedSymbolsForNode(node, position) {
-        const data = await this.client.apiRequest("getReferencedSymbolsForNode", {
-            snapshot: this.snapshotId,
-            project: this.project.id,
-            node: getNodeId(node),
-            position,
-        });
-        return (data ?? []).map(entry => ({
-            definition: new NodeHandle(entry.definition, this.project),
-            symbol: entry.symbol ? this.objectRegistry.getOrCreateSymbol(entry.symbol) : undefined,
-            references: (entry.references ?? []).map(h => new NodeHandle(h, this.project)),
-        }));
-    }
-    async getSignatureUsage(signatureDecl) {
-        const data = await this.client.apiRequest("getSignatureUsages", {
+    /**
+     * Get the type of a symbol, excluding the missing type when
+     * `exactOptionalPropertyTypes: true` is set; for symbols whose
+     * type cannot be determined the checker yields the error type
+     * (use {@link Type.isErrorType} to detect it).
+     */
+    async getNonMissingTypeOfSymbol(symbol) {
+        const data = await this.client.apiRequest("getNonMissingTypeOfSymbol", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            signatureDecl: getNodeId(signatureDecl),
+            symbol: symbol.reference,
         });
-        return (data ?? []).map(entry => ({
-            name: new NodeHandle(entry.name, this.project),
-            call: entry.call ? new NodeHandle(entry.call, this.project) : undefined,
-        }));
+        return this.objectRegistry.getOrCreateType(data);
     }
-    async getCompletionsAtPosition(document, position, options) {
-        const data = await this.client.apiRequest("getCompletionsAtPosition", {
+    async getReferencesToSymbolInFile(file, symbol) {
+        const data = await this.client.apiRequest("getReferencesToSymbolInFile", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            file: document,
-            position,
-            triggerCharacter: options?.triggerCharacter,
-            includeSymbol: options?.includeSymbol,
+            file,
+            symbol: symbol.reference,
         });
-        if (!data)
-            return undefined;
-        return {
-            isIncomplete: data.isIncomplete,
-            entries: data.entries.map(e => ({
-                ...e,
-                symbol: e.symbol ? this.objectRegistry.getOrCreateSymbol(e.symbol) : undefined,
-            })),
-        };
+        return (data ?? []).map(h => new NodeHandle(h, this.project));
     }
     async getTypeAtLocation(nodeOrNodes) {
         if (Array.isArray(nodeOrNodes)) {
@@ -737,31 +1803,30 @@ export class Checker {
                 project: this.project.id,
                 locations: nodeOrNodes.map(node => getNodeId(node)),
             });
-            return data.map(d => d ? this.objectRegistry.getOrCreateType(d) : undefined);
+            return data.map(d => this.objectRegistry.getOrCreateType(d));
         }
         const data = await this.client.apiRequest("getTypeAtLocation", {
             snapshot: this.snapshotId,
             project: this.project.id,
             location: getNodeId(nodeOrNodes),
         });
-        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
+        return this.objectRegistry.getOrCreateType(data);
     }
     async getSignaturesOfType(type, kind) {
-        const data = await this.client.apiRequest("getSignaturesOfType", {
-            snapshot: this.snapshotId,
-            project: this.project.id,
-            type: type.id,
-            kind,
-        });
-        return data.map(d => this.objectRegistry.getOrCreateSignature(d));
+        return kind === SignatureKind.Call ? type.getCallSignatures() : type.getConstructSignatures();
     }
+    /**
+     * Get the resolved signature of a call-like expression. Always returns a
+     * signature; when a call cannot be resolved the checker yields the unknown
+     * signature (use {@link Checker.isUnknownSignature} to detect it).
+     */
     async getResolvedSignature(node) {
         const data = await this.client.apiRequest("getResolvedSignature", {
             snapshot: this.snapshotId,
             project: this.project.id,
             location: getNodeId(node),
         });
-        return data ? this.objectRegistry.getOrCreateSignature(data) : undefined;
+        return this.objectRegistry.getOrCreateSignature(data);
     }
     async getTypeAtPosition(file, positionOrPositions) {
         if (typeof positionOrPositions === "number") {
@@ -796,6 +1861,22 @@ export class Checker {
         });
         return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
     }
+    /**
+     * Returns all symbols with the given meaning that are visible at `location`.
+     */
+    async getSymbolsInScope(location, meaning) {
+        // Distinguish Node (has `kind`) from DocumentPosition (has `document` and `position`)
+        const isNode = "kind" in location;
+        const data = await this.client.apiRequest("getSymbolsInScope", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            meaning,
+            location: isNode ? getNodeId(location) : undefined,
+            file: isNode ? undefined : location.document,
+            position: isNode ? undefined : location.position,
+        });
+        return data ? data.map(d => this.objectRegistry.getOrCreateSymbol(d)) : [];
+    }
     async getResolvedSymbol(node) {
         const text = node.text;
         if (!text)
@@ -810,38 +1891,62 @@ export class Checker {
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
     }
-    async getBaseTypeOfLiteralType(type) {
-        const data = await this.client.apiRequest("getBaseTypeOfLiteralType", {
+    async getContextualTypeForArgumentAtIndex(node, argIndex) {
+        const data = await this.client.apiRequest("getContextualTypeForArgument", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            type: type.id,
+            location: getNodeId(node),
+            index: argIndex,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
     }
-    async getNonNullableType(type) {
-        const data = await this.client.apiRequest("getNonNullableType", {
+    async getAwaitedType(type) {
+        const data = await this.client.apiRequest("getAwaitedType", {
             snapshot: this.snapshotId,
             project: this.project.id,
             type: type.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
     }
+    /** Get the base type of a literal type (e.g. `number` for `42`). Always returns a type. */
+    async getBaseTypeOfLiteralType(type) {
+        const data = await this.client.apiRequest("getBaseTypeOfLiteralType", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            type: type.id,
+        });
+        return this.objectRegistry.getOrCreateType(data);
+    }
+    /** Get the type with `null` and `undefined` removed. Always returns a type. */
+    async getNonNullableType(type) {
+        return type.getNonNullableType();
+    }
+    /**
+     * Get the type for a type node. Always returns a type; for type nodes whose
+     * type cannot be determined the checker yields the error type (use
+     * {@link Type.isErrorType} to detect it).
+     */
     async getTypeFromTypeNode(node) {
         const data = await this.client.apiRequest("getTypeFromTypeNode", {
             snapshot: this.snapshotId,
             project: this.project.id,
             location: getNodeId(node),
         });
-        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
+        return this.objectRegistry.getOrCreateType(data);
     }
+    /** Get the widened type. Always returns a type. */
     async getWidenedType(type) {
         const data = await this.client.apiRequest("getWidenedType", {
             snapshot: this.snapshotId,
             project: this.project.id,
             type: type.id,
         });
-        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
+        return this.objectRegistry.getOrCreateType(data);
     }
+    /**
+     * Get the type of the parameter at the given index in a signature. Always
+     * returns a type; an out-of-range index yields the `any` type.
+     */
     async getParameterType(signature, index) {
         const data = await this.client.apiRequest("getParameterType", {
             snapshot: this.snapshotId,
@@ -849,7 +1954,7 @@ export class Checker {
             signature: signature.id,
             index,
         });
-        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
+        return this.objectRegistry.getOrCreateType(data);
     }
     async isArrayLikeType(type) {
         return this.client.apiRequest("isArrayLikeType", {
@@ -883,11 +1988,9 @@ export class Checker {
         const data = await this.client.apiRequest("getTypeOfSymbolAtLocation", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            symbol: symbol.id,
+            symbol: symbol.reference,
             location: getNodeId(location),
         });
-        if (!data)
-            throw new Error(`getTypeOfSymbolAtLocation returned no type for symbol ${symbol.id}`);
         return this.objectRegistry.getOrCreateType(data);
     }
     async getIntrinsicType(method) {
@@ -930,6 +2033,9 @@ export class Checker {
     async getESSymbolType() {
         return this.getIntrinsicType("getESSymbolType");
     }
+    async getNonPrimitiveType() {
+        return this.getIntrinsicType("getNonPrimitiveType");
+    }
     async typeToTypeNode(type, enclosingDeclaration, flags) {
         const binaryData = await this.client.apiRequestBinary("typeToTypeNode", {
             snapshot: this.snapshotId,
@@ -956,13 +2062,16 @@ export class Checker {
         return decodeNode(binaryData);
     }
     async typeToString(type, enclosingDeclaration, flags) {
-        return this.client.apiRequest("typeToString", {
+        const result = await this.client.apiRequest("typeToString", {
             snapshot: this.snapshotId,
             project: this.project.id,
             type: type.id,
             location: enclosingDeclaration ? getNodeId(enclosingDeclaration) : undefined,
             flags,
         });
+        if (typeof result !== "string")
+            throw new TypeError("typeToString returned a non-string result");
+        return result;
     }
     async isContextSensitive(node) {
         return this.client.apiRequest("isContextSensitive", {
@@ -979,27 +2088,42 @@ export class Checker {
         });
     }
     async isTupleType(type) {
-        return this.client.apiRequest("isTupleType", {
+        return type.isTupleType();
+    }
+    async isTupleTypeTarget(type) {
+        return type.isTupleTypeTarget();
+    }
+    /**
+     * The following symbols are considered read-only:
+     * - Properties with a `readonly` modifier
+     * - Variables declared with `const`
+     * - Get accessors without matching set accessors
+     * - Enum members
+     * - `Object.defineProperty` assignments with `writable: false` or no setter
+     * - Unions and intersections of the above
+     */
+    async isReadonlySymbol(symbol) {
+        return this.client.apiRequest("isReadonlySymbol", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            type: type.id,
+            symbol: symbol.reference,
         });
     }
+    /** Get the return type of a signature. Always returns a type. */
     async getReturnTypeOfSignature(signature) {
-        const data = await this.client.apiRequest("getReturnTypeOfSignature", {
-            snapshot: this.snapshotId,
-            project: this.project.id,
-            signature: signature.id,
-        });
-        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
+        return signature.getReturnType();
     }
+    /**
+     * Get the rest type of a signature. Always returns a type; a signature with
+     * no rest parameter yields the `any` type.
+     */
     async getRestTypeOfSignature(signature) {
         const data = await this.client.apiRequest("getRestTypeOfSignature", {
             snapshot: this.snapshotId,
             project: this.project.id,
             signature: signature.id,
         });
-        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
+        return this.objectRegistry.getOrCreateType(data);
     }
     async getTypePredicateOfSignature(signature) {
         const data = await this.client.apiRequest("getTypePredicateOfSignature", {
@@ -1021,55 +2145,57 @@ export class Checker {
      * yields an empty array.
      */
     async getBaseTypes(type) {
-        const data = await this.client.apiRequest("getBaseTypes", {
-            snapshot: this.snapshotId,
-            project: this.project.id,
-            type: type.id,
-        });
-        return data ? data.map(d => this.objectRegistry.getOrCreateType(d)) : [];
+        return await type.getBaseTypes() ?? [];
     }
+    /** Get the apparent type of a type. Always returns a type. */
     async getApparentType(type) {
-        const data = await this.client.apiRequest("getApparentType", {
-            snapshot: this.snapshotId,
-            project: this.project.id,
-            type: type.id,
-        });
-        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
+        return type.getApparentType();
+    }
+    /** Get the reduced type of a type. Always returns a type. */
+    async getReducedType(type) {
+        return type.getReducedType();
     }
     async getPropertiesOfType(type) {
-        const data = await this.client.apiRequest("getPropertiesOfType", {
+        return type.getProperties();
+    }
+    async getIndexInfosOfType(type) {
+        return type.getIndexInfos();
+    }
+    async getIndexInfoOfType(type, kind) {
+        const data = await this.client.apiRequest("getIndexInfoOfType", {
             snapshot: this.snapshotId,
             project: this.project.id,
             type: type.id,
+            kind,
         });
-        return data ? data.map(d => this.objectRegistry.getOrCreateSymbol(d)) : [];
+        return data ? {
+            keyType: this.objectRegistry.getOrCreateType(data.keyType),
+            valueType: this.objectRegistry.getOrCreateType(data.valueType),
+            isReadonly: data.isReadonly ?? false,
+            declaration: data.declaration ? new NodeHandle(data.declaration, this.project) : undefined,
+        } : undefined;
     }
-    async getIndexInfosOfType(type) {
-        const data = await this.client.apiRequest("getIndexInfosOfType", {
+    async getIndexTypeOfType(type, kind) {
+        return kind === IndexKind.String ? type.getStringIndexType() : type.getNumberIndexType();
+    }
+    async getTypeOfPropertyOfType(type, propertyName) {
+        const data = await this.client.apiRequest("getTypeOfPropertyOfType", {
             snapshot: this.snapshotId,
             project: this.project.id,
             type: type.id,
+            name: propertyName,
         });
-        if (!data)
-            return [];
-        return data.map(d => ({
-            keyType: this.objectRegistry.getOrCreateType(d.keyType),
-            valueType: this.objectRegistry.getOrCreateType(d.valueType),
-            isReadonly: d.isReadonly ?? false,
-            declaration: d.declaration ? new NodeHandle(d.declaration, this.project) : undefined,
-        }));
+        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
     }
     /**
      * Get the constraint of a type parameter (the `T` in `<U extends T>`), or
      * undefined if it has none.
      */
     async getConstraintOfTypeParameter(type) {
-        const data = await this.client.apiRequest("getConstraintOfTypeParameter", {
-            snapshot: this.snapshotId,
-            project: this.project.id,
-            type: type.id,
-        });
-        return data ? this.objectRegistry.getOrCreateType(data) : undefined;
+        return type.getConstraint();
+    }
+    async getDefaultFromTypeParameter(type) {
+        return type.getDefault();
     }
     async getBaseConstraintOfType(type) {
         const data = await this.client.apiRequest("getBaseConstraintOfType", {
@@ -1094,15 +2220,28 @@ export class Checker {
             project: this.project.id,
             location: getNodeId(node),
         });
-        return data ?? undefined;
+        if (!data || (typeof data.value !== "string" && typeof data.value !== "number")) {
+            return undefined;
+        }
+        if (data.isNumber && typeof data.value === "string") {
+            if (data.value === "+Infinity") {
+                return Infinity;
+            }
+            else if (data.value === "-Infinity") {
+                return -Infinity;
+            }
+            return NaN;
+        }
+        return data.value;
     }
+    /** Get the signature of a function-like declaration. Always returns a signature. */
     async getSignatureFromDeclaration(node) {
         const data = await this.client.apiRequest("getSignatureFromDeclaration", {
             snapshot: this.snapshotId,
             project: this.project.id,
             location: getNodeId(node),
         });
-        return data ? this.objectRegistry.getOrCreateSignature(data) : undefined;
+        return this.objectRegistry.getOrCreateSignature(data);
     }
     async getExportSpecifierLocalTargetSymbol(node) {
         const data = await this.client.apiRequest("getExportSpecifierLocalTargetSymbol", {
@@ -1121,20 +2260,51 @@ export class Checker {
         const data = await this.client.apiRequest("getAliasedSymbol", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            symbol: symbol.id,
+            symbol: symbol.reference,
         });
-        if (!data)
-            throw new Error(`getAliasedSymbol returned no symbol for symbol ${symbol.id}`);
         return this.objectRegistry.getOrCreateSymbol(data);
     }
+    /**
+     * Get the fully qualified name of a symbol, walking up its parent chain
+     * (e.g. `"/path/to/module".Namespace.Name`).
+     */
+    async getFullyQualifiedName(symbol) {
+        return this.client.apiRequest("getFullyQualifiedName", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            symbol: symbol.reference,
+        });
+    }
     async getImmediateAliasedSymbol(symbol) {
         const data = await this.client.apiRequest("getImmediateAliasedSymbol", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            symbol: symbol.id,
+            symbol: symbol.reference,
         });
         return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
     }
+    /**
+     * Get the target symbol if instantiated, or the provided symbol otherwise.
+     */
+    async getTargetSymbol(symbol) {
+        if (symbol.checkFlags & CheckFlags.Instantiated) {
+            const data = await this.client.apiRequest("getTargetSymbol", {
+                snapshot: this.snapshotId,
+                project: this.project.id,
+                symbol: symbol.reference,
+            });
+            return this.objectRegistry.getOrCreateSymbol(data);
+        }
+        return symbol;
+    }
+    async getExportSymbolOfSymbol(symbol) {
+        const data = await this.client.apiRequest("getExportSymbolOfSymbolForChecker", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+            symbol: symbol.reference,
+        });
+        return this.objectRegistry.getOrCreateSymbol(data);
+    }
     /**
      * Fetch (once, then cache) the handle ids of the per-checker singleton
      * symbols (unknown, undefined, arguments). These ids are stable for the life
@@ -1166,11 +2336,30 @@ export class Checker {
     async isArgumentsSymbol(symbol) {
         return symbol.id === (await this.getWellKnownSymbols()).arguments;
     }
+    /**
+     * Fetch (once, then cache) the handle id of the per-checker unknown
+     * signature. This id is stable for the life of the project's checker, so
+     * identity checks against it are local after the first call.
+     */
+    getWellKnownSignatures() {
+        return this.wellKnownSignatures ??= this.client.apiRequest("getWellKnownSignatures", {
+            snapshot: this.snapshotId,
+            project: this.project.id,
+        });
+    }
+    /**
+     * Returns `true` if the signature is the checker's "unknown" signature (e.g.
+     * the result of {@link Checker.getResolvedSignature} on a call that cannot be
+     * resolved).
+     */
+    async isUnknownSignature(signature) {
+        return signature.id === (await this.getWellKnownSignatures()).unknown;
+    }
     async getExportsOfModule(symbol) {
         const data = await this.client.apiRequest("getExportsOfModule", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            symbol: symbol.id,
+            symbol: symbol.reference,
         });
         return data ? data.map(d => this.objectRegistry.getOrCreateSymbol(d)) : [];
     }
@@ -1178,7 +2367,7 @@ export class Checker {
         const data = await this.client.apiRequest("getMemberInModuleExports", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            symbol: symbol.id,
+            symbol: symbol.reference,
             name,
         });
         return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
@@ -1187,7 +2376,7 @@ export class Checker {
         const data = await this.client.apiRequest("getJsDocTags", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            symbol: symbol.id,
+            symbol: symbol.reference,
         });
         return data ?? [];
     }
@@ -1195,7 +2384,7 @@ export class Checker {
         return this.client.apiRequest("getDocumentationComment", {
             snapshot: this.snapshotId,
             project: this.project.id,
-            symbol: symbol.id,
+            symbol: symbol.reference,
         });
     }
     /**
@@ -1210,7 +2399,7 @@ export class Checker {
         return data ? data.map(d => this.objectRegistry.getOrCreateType(d)) : [];
     }
 }
-export class Emitter {
+export class Printer {
     client;
     constructor(client) {
         this.client = client;
@@ -1220,7 +2409,19 @@ export class Emitter {
         const base64 = uint8ArrayToBase64(encoded);
         return this.client.apiRequest("printNode", {
             data: base64,
-            ...options,
+            preserveSourceNewlines: options.preserveSourceNewlines,
+            neverAsciiEscape: options.neverAsciiEscape,
+            terminateUnterminatedLiterals: options.terminateUnterminatedLiterals,
+        });
+    }
+    async printFile(sourceFile, options = {}) {
+        const encoded = encodeNode(sourceFile);
+        const base64 = uint8ArrayToBase64(encoded);
+        return this.client.apiRequest("printNode", {
+            data: base64,
+            preserveSourceNewlines: options.preserveSourceNewlines,
+            neverAsciiEscape: options.neverAsciiEscape,
+            terminateUnterminatedLiterals: options.terminateUnterminatedLiterals,
         });
     }
 }
@@ -1231,71 +2432,89 @@ export class NodeHandle {
      * is remembered so callers don't have to pass it explicitly.
      */
     canonicalProject;
+    /** The owning source file of a file-owned symbol's declaration. */
+    fileOwner;
     index;
     kind;
     path;
-    constructor(handle, canonicalProject) {
-        const parsed = parseNodeHandle(handle);
+    constructor(handle, canonicalProject, fileOwner) {
+        const parsed = parseNodeHandleFromCompiler(handle);
         this.index = parsed.index;
         this.kind = parsed.kind;
         this.path = parsed.path;
         this.canonicalProject = canonicalProject;
+        this.fileOwner = fileOwner;
     }
     /**
      * Resolve this handle to the actual AST node by fetching the source file from a project
      * and looking up the node by index. If no project is passed, the project that produced
-     * the handle is used.
+     * the handle is used. Declarations of file-owned symbols identify an exact source file and
+     * resolve through it, independently of any project.
      */
     async resolve(project = this.canonicalProject) {
-        const sourceFile = await project.program.getSourceFile(this.path);
+        if (this.fileOwner) {
+            const sourceFile = this.fileOwner.record.file ?? await this.fetchOwnerFile(this.fileOwner);
+            return sourceFile.getOrCreateNodeAtIndex(this.index);
+        }
+        if (!project)
+            throw new Error(`Node handle for '${this.path}' has no project context`);
+        const sourceFile = await project.program.getSourceFileByPath(this.path);
         if (!sourceFile) {
             return undefined;
         }
         return sourceFile.getOrCreateNodeAtIndex(this.index);
     }
+    async fetchOwnerFile(fileOwner) {
+        const data = await fileOwner.api.client.apiRequestBinary("getCachedSourceFile", { file: fileOwner.record.descriptor });
+        if (!data)
+            throw new Error(`Source file '${fileOwner.record.descriptor.fileName}' is not available`);
+        return fileOwner.api.sourceFileCache.attachFile(fileOwner.record, new RemoteSourceFile(data, new Wtf8Decoder(), fileOwner.api.client.getTimingCollector(), fileOwner.api));
+    }
 }
 export class Symbol {
-    objectRegistry;
-    /**
-     * The project this symbol was first observed in, used as the default project for
-     * lookups that need a project context (members/exports/parent). Symbols are shared
-     * snapshot-wide, so these lookups can otherwise be ambiguous about which project to use.
-     */
-    canonicalProject;
-    id;
+    storage;
+    get id() {
+        return this.reference.id;
+    }
     /** The escaped (`__String`) name, used as the key in member/export tables. */
     escapedName;
     /** The display name (escaped underscores removed). */
     name;
     flags;
     checkFlags;
+    /** @internal */
+    reference;
     declarations;
     valueDeclaration;
     parent;
     exportSymbol;
     membersCache;
     exportsCache;
-    constructor(data, objectRegistry) {
-        this.objectRegistry = objectRegistry;
-        this.id = data.id;
+    constructor(data, storage) {
+        if (data.reference.kind !== storage.kind)
+            throw new Error(`Symbol ${data.reference.id} has mismatched ownership and storage`);
+        this.storage = storage;
+        this.reference = data.reference;
         this.escapedName = data.name;
         this.name = unescapeLeadingUnderscores(data.name);
         this.flags = data.flags;
         this.checkFlags = data.checkFlags;
-        const canonicalProject = objectRegistry.getProject(data.project);
-        if (!canonicalProject) {
-            throw new Error(`Symbol ${data.id} references unknown canonical project '${data.project}'`);
-        }
-        this.canonicalProject = canonicalProject;
-        this.declarations = (data.declarations ?? []).map(d => new NodeHandle(d, canonicalProject));
-        this.valueDeclaration = data.valueDeclaration ? new NodeHandle(data.valueDeclaration, canonicalProject) : undefined;
+        // A file-owned symbol has no canonical project; its declarations resolve through its file.
+        const project = storage.kind === SymbolOwnerKind.Snapshot ? storage.registry.project : undefined;
+        const fileOwner = storage.kind === SymbolOwnerKind.File ? storage.owner : undefined;
+        this.declarations = (data.declarations ?? []).map(handle => new NodeHandle(handle, project, fileOwner));
+        this.valueDeclaration = data.valueDeclaration
+            ? new NodeHandle(data.valueDeclaration, project, fileOwner)
+            : undefined;
         if (data.parent !== undefined)
             this.parent = data.parent;
         if (data.exportSymbol !== undefined)
             this.exportSymbol = data.exportSymbol;
     }
     async getParent() {
-        return this.objectRegistry.fetchSymbol(this, "getParentOfSymbol", this.parent, this.canonicalProject.id);
+        if (!this.parent)
+            return undefined;
+        return this.fetchSymbol("getParentOfSymbol", this.parent);
     }
     /**
      * Get this symbol's members keyed by escaped name. The result is cached on
@@ -1312,7 +2531,7 @@ export class Symbol {
         return this.exportsCache ??= this.fetchSymbolTable("getExportsOfSymbol");
     }
     async fetchSymbolTable(method) {
-        const symbols = await this.objectRegistry.fetchSymbols(this, method, undefined, this.canonicalProject.id);
+        const symbols = await this.fetchSymbols(method);
         const table = new Map();
         for (const symbol of symbols) {
             table.set(symbol.escapedName, symbol);
@@ -1322,7 +2541,7 @@ export class Symbol {
     async getExportSymbol() {
         if (!this.exportSymbol)
             return this;
-        return this.objectRegistry.fetchSymbol(this, "getExportSymbolOfSymbol", this.exportSymbol, this.canonicalProject.id);
+        return this.fetchSymbol("getExportSymbolOfSymbol", this.exportSymbol);
     }
     async getJsDocTags(checker) {
         return checker.getJsDocTagsOfSymbol(this);
@@ -1330,9 +2549,40 @@ export class Symbol {
     async getDocumentationComment(checker) {
         return checker.getDocumentationCommentOfSymbol(this);
     }
+    async fetchSymbol(method, reference) {
+        if (this.storage.kind === SymbolOwnerKind.Snapshot) {
+            return this.storage.registry.fetchSymbol(this, method, reference);
+        }
+        const fileOwner = this.storage.owner;
+        // A file-owned symbol's relationships are always owned by the same file.
+        const cached = reference.file === fileOwner.record.descriptor.nodeId ? fileOwner.record.symbolsById.get(reference.id) : undefined;
+        if (cached)
+            return cached;
+        const data = await fileOwner.api.client.apiRequest(method, { symbol: this.reference });
+        if (!data)
+            throw new Error(`${method} returned null symbol for Symbol ${this.id}`);
+        return this.internFileSymbol(fileOwner, data);
+    }
+    async fetchSymbols(method) {
+        if (this.storage.kind === SymbolOwnerKind.Snapshot) {
+            return this.storage.registry.fetchSymbols(this, method);
+        }
+        const fileOwner = this.storage.owner;
+        const data = await fileOwner.api.client.apiRequest(method, { symbol: this.reference });
+        return data?.map(symbol => this.internFileSymbol(fileOwner, symbol)) ?? [];
+    }
+    internFileSymbol(fileOwner, data) {
+        validateSymbolResponse(data);
+        const reference = data.reference;
+        if (reference.kind !== SymbolOwnerKind.File)
+            throw new Error(`Symbol ${reference.id} is not file-owned`);
+        return fileOwner.api.sourceFileCache.getOrCreateSymbol(fileOwner.record, reference.file, reference.id, () => new Symbol(data, { kind: SymbolOwnerKind.File, owner: fileOwner }));
+    }
 }
 class TypeObject {
     objectRegistry;
+    // Fields included in TypeResponse. References to other objects are stored as IDs
+    // and resolved lazily via the object registry.
     id;
     flags;
     objectFlags;
@@ -1343,14 +2593,17 @@ class TypeObject {
     freshType;
     regularType;
     target;
+    tupleType;
     typeParameters;
     outerTypeParameters;
     localTypeParameters;
+    thisType;
     aliasTypeArguments;
     aliasSymbol;
     elementFlags;
     fixedLength;
     readonly;
+    labeledElementDeclarations;
     texts;
     objectType;
     indexType;
@@ -1358,8 +2611,31 @@ class TypeObject {
     extendsType;
     baseType;
     substConstraint;
-    trueType; // false if not yet loaded
-    falseType; // false if not yet loaded
+    typeParameter;
+    constraintType;
+    nameType;
+    templateType;
+    // Cached results of lazy fetches, not included in TypeResponse
+    // (typically because they require some amount of computation or
+    // could cause an arbitrarily large number of types to be cached
+    // on the server for ID-based lookup). `false` is a sentinel value
+    // indicating a fetch has not yet occurred.
+    trueType;
+    falseType;
+    constraint;
+    default;
+    nonNullableType;
+    apparentType;
+    reducedType;
+    properties;
+    apparentProperties;
+    callSignatures;
+    constructSignatures;
+    indexInfos;
+    baseTypes;
+    types;
+    stringIndexType;
+    numberIndexType;
     constructor(data, objectRegistry) {
         this.objectRegistry = objectRegistry;
         this.id = data.id;
@@ -1371,7 +2647,25 @@ class TypeObject {
         if (data.value != null) {
             // BigInt literal values are serialized as decimal strings (e.g. "-123") because
             // JSON cannot represent bigint. Decode them back into a real bigint here.
-            this.value = (data.flags & TypeFlags.BigIntLiteral) ? BigInt(data.value) : data.value;
+            const value = data.value;
+            if (data.flags & TypeFlags.BigIntLiteral) {
+                this.value = BigInt(value);
+            }
+            // JSON cannot represent infinities, so the API serializes them as strings.
+            else if (data.flags & TypeFlags.NumberLiteral && typeof value === "string") {
+                if (value === "+Infinity") {
+                    this.value = Infinity;
+                }
+                else if (value === "-Infinity") {
+                    this.value = -Infinity;
+                }
+                else {
+                    this.value = NaN;
+                }
+            }
+            else {
+                this.value = value;
+            }
         }
         if (data.intrinsicName !== undefined)
             this.intrinsicName = data.intrinsicName;
@@ -1383,18 +2677,24 @@ class TypeObject {
             this.regularType = data.regularType;
         if (data.target !== undefined)
             this.target = data.target;
+        this.tupleType = data.isTupleType ?? false;
         this.typeParameters = data.typeParameters ?? [];
         this.outerTypeParameters = data.outerTypeParameters ?? [];
         this.localTypeParameters = data.localTypeParameters ?? [];
+        if (data.thisType !== undefined)
+            this.thisType = data.thisType;
         this.aliasTypeArguments = data.aliasTypeArguments ?? [];
         if (data.aliasSymbol !== undefined)
             this.aliasSymbol = data.aliasSymbol;
-        if (data.elementFlags !== undefined)
-            this.elementFlags = data.elementFlags;
-        if (data.fixedLength !== undefined)
+        if (data.fixedLength !== undefined) {
+            this.elementFlags = data.elementFlags ?? [];
             this.fixedLength = data.fixedLength;
+        }
         if (data.readonly !== undefined)
             this.readonly = data.readonly;
+        if (data.labeledElementDeclarations !== undefined) {
+            this.labeledElementDeclarations = data.labeledElementDeclarations.map(handle => handle ? objectRegistry.createNodeHandle(handle) : undefined);
+        }
         if (data.texts !== undefined)
             this.texts = data.texts;
         if (data.objectType !== undefined)
@@ -1409,12 +2709,102 @@ class TypeObject {
             this.baseType = data.baseType;
         if (data.substConstraint !== undefined)
             this.substConstraint = data.substConstraint;
+        if (data.typeParameter !== undefined)
+            this.typeParameter = data.typeParameter;
+        if (data.constraintType !== undefined)
+            this.constraintType = data.constraintType;
+        if (data.nameType !== undefined)
+            this.nameType = data.nameType;
+        if (data.templateType !== undefined)
+            this.templateType = data.templateType;
         this.trueType = false;
         this.falseType = false;
+        this.constraint = false;
+        this.default = false;
+        this.nonNullableType = false;
+        this.apparentType = false;
+        this.reducedType = false;
+        this.properties = false;
+        this.apparentProperties = false;
+        this.callSignatures = false;
+        this.constructSignatures = false;
+        this.indexInfos = false;
+        this.baseTypes = false;
+        this.types = false;
+        this.stringIndexType = false;
+        this.numberIndexType = false;
     }
     async getSymbol() {
         return this.objectRegistry.fetchSymbol(this, "getSymbolOfType", this.symbol);
     }
+    async getProperties() {
+        if (this.properties === false) {
+            this.properties = await this.objectRegistry.fetchPropertiesOfType(this);
+        }
+        return this.properties;
+    }
+    getProperty(propertyName) {
+        return this.objectRegistry.fetchPropertyOfType(this, propertyName);
+    }
+    async getApparentProperties() {
+        if (this.apparentProperties === false) {
+            this.apparentProperties = await this.objectRegistry.fetchApparentPropertiesOfType(this);
+        }
+        return this.apparentProperties;
+    }
+    async getCallSignatures() {
+        if (this.callSignatures === false) {
+            this.callSignatures = await this.objectRegistry.fetchSignaturesOfType(this, SignatureKind.Call);
+        }
+        return this.callSignatures;
+    }
+    async getConstructSignatures() {
+        if (this.constructSignatures === false) {
+            this.constructSignatures = await this.objectRegistry.fetchSignaturesOfType(this, SignatureKind.Construct);
+        }
+        return this.constructSignatures;
+    }
+    async getNonNullableType() {
+        const result = await this.objectRegistry.fetchType(this, "getNonNullableType", this.nonNullableType);
+        this.nonNullableType = result.id;
+        return result;
+    }
+    async getStringIndexType() {
+        if (this.stringIndexType === false) {
+            this.stringIndexType = await this.getStringIndexTypeWorker();
+        }
+        return this.stringIndexType;
+    }
+    async getStringIndexTypeWorker() {
+        const infos = await this.getIndexInfos();
+        return infos.find(info => (info.keyType.flags & TypeFlags.String) !== 0)?.valueType;
+    }
+    async getNumberIndexType() {
+        if (this.numberIndexType === false) {
+            this.numberIndexType = await this.getNumberIndexTypeWorker();
+        }
+        return this.numberIndexType;
+    }
+    async getNumberIndexTypeWorker() {
+        const infos = await this.getIndexInfos();
+        return infos.find(info => (info.keyType.flags & TypeFlags.Number) !== 0)?.valueType;
+    }
+    async getApparentType() {
+        const result = await this.objectRegistry.fetchType(this, "getApparentType", this.apparentType);
+        this.apparentType = result.id;
+        return result;
+    }
+    async getReducedType() {
+        const result = await this.objectRegistry.fetchType(this, "getReducedType", this.reducedType);
+        this.reducedType = result.id;
+        return result;
+    }
+    async getIndexInfos() {
+        if (this.indexInfos === false) {
+            this.indexInfos = await this.objectRegistry.fetchIndexInfosOfType(this);
+        }
+        return this.indexInfos;
+    }
     async getAliasSymbol() {
         return this.objectRegistry.fetchSymbol(this, "getAliasSymbolOfType", this.aliasSymbol);
     }
@@ -1422,10 +2812,10 @@ class TypeObject {
         return this.objectRegistry.fetchType(this, "getTargetOfType", this.target);
     }
     async getFreshType() {
-        return this.objectRegistry.fetchType(this, "getFreshTypeOfType", this.freshType);
+        return this.objectRegistry.fetchOptionalType(this, "getFreshTypeOfType", this.freshType);
     }
     async getRegularType() {
-        return this.objectRegistry.fetchType(this, "getRegularTypeOfType", this.regularType);
+        return this.objectRegistry.fetchOptionalType(this, "getRegularTypeOfType", this.regularType);
     }
     async getTypes() {
         // Only union, intersection, and template literal types have constituent
@@ -1434,7 +2824,10 @@ class TypeObject {
         if (!(this.flags & (TypeFlags.UnionOrIntersection | TypeFlags.TemplateLiteral))) {
             return undefined;
         }
-        return this.objectRegistry.fetchTypes(this, "getTypesOfType");
+        if (this.types === false) {
+            this.types = await this.objectRegistry.fetchTypes(this, "getTypesOfType");
+        }
+        return this.types;
     }
     async getTypeParameters() {
         return this.objectRegistry.fetchTypes(this, "getTypeParametersOfType", this.typeParameters);
@@ -1445,9 +2838,24 @@ class TypeObject {
     async getLocalTypeParameters() {
         return this.objectRegistry.fetchTypes(this, "getLocalTypeParametersOfType", this.localTypeParameters);
     }
+    async getThisType() {
+        return this.objectRegistry.fetchOptionalType(this, "getThisTypeOfType", this.thisType);
+    }
     async getAliasTypeArguments() {
         return this.objectRegistry.fetchTypes(this, "getAliasTypeArgumentsOfType", this.aliasTypeArguments);
     }
+    async getTypeParameter() {
+        return this.objectRegistry.fetchType(this, "getTypeParameterOfMappedType", this.typeParameter);
+    }
+    async getConstraintType() {
+        return this.objectRegistry.fetchType(this, "getConstraintTypeOfMappedType", this.constraintType);
+    }
+    async getNameType() {
+        return this.objectRegistry.fetchOptionalType(this, "getNameTypeOfMappedType", this.nameType);
+    }
+    async getTemplateType() {
+        return this.objectRegistry.fetchType(this, "getTemplateTypeOfMappedType", this.templateType);
+    }
     async getObjectType() {
         return this.objectRegistry.fetchType(this, "getObjectTypeOfType", this.objectType);
     }
@@ -1464,8 +2872,20 @@ class TypeObject {
         return this.objectRegistry.fetchType(this, "getBaseTypeOfType", this.baseType);
     }
     async getConstraint() {
+        // Type parameters resolve their constraint lazily through the checker,
+        // whereas substitution types carry a preloaded constraint handle.
+        if (this.flags & TypeFlags.TypeParameter) {
+            const result = await this.objectRegistry.fetchOptionalType(this, "getConstraintOfTypeParameter", this.constraint);
+            this.constraint = result ? result.id : 0;
+            return result;
+        }
         return this.objectRegistry.fetchType(this, "getConstraintOfType", this.substConstraint);
     }
+    async getDefault() {
+        const result = await this.objectRegistry.fetchOptionalType(this, "getDefaultFromTypeParameter", this.default);
+        this.default = result ? result.id : 0;
+        return result;
+    }
     async getTrueType() {
         const result = await this.objectRegistry.fetchType(this, "getTrueTypeOfConditionalType", this.trueType);
         this.trueType = result.id;
@@ -1484,7 +2904,10 @@ class TypeObject {
         if (!this.isClassOrInterface()) {
             return undefined;
         }
-        return this.objectRegistry.fetchBaseTypes(this);
+        if (this.baseTypes === false) {
+            this.baseTypes = await this.objectRegistry.fetchBaseTypes(this);
+        }
+        return this.baseTypes;
     }
     isClassOrInterface() {
         return isClassOrInterfaceType(this);
@@ -1523,7 +2946,10 @@ class TypeObject {
         return isTypeReference(this);
     }
     isTupleType() {
-        return isTupleType(this);
+        return this.tupleType;
+    }
+    isTupleTypeTarget() {
+        return this.fixedLength !== undefined;
     }
     isIndexType() {
         return isIndexType(this);
@@ -1546,6 +2972,9 @@ class TypeObject {
     isTypeParameter() {
         return isTypeParameter(this);
     }
+    isMappedType() {
+        return !!(this.flags & TypeFlags.Object) && !!(this.objectFlags & ObjectFlags.Mapped);
+    }
 }
 export function isUnionType(type) {
     return (type.flags & TypeFlags.Union) !== 0;
@@ -1590,7 +3019,10 @@ export function isTypeReference(type) {
     return isObjectType(type) && (type.objectFlags & ObjectFlags.Reference) !== 0;
 }
 export function isTupleType(type) {
-    return isObjectType(type) && (type.objectFlags & ObjectFlags.Tuple) !== 0;
+    return type.isTupleType();
+}
+export function isTupleTypeTarget(type) {
+    return type.isTupleTypeTarget();
 }
 export function isIndexType(type) {
     return (type.flags & TypeFlags.Index) !== 0;
@@ -1622,6 +3054,7 @@ export class Signature {
     parameters;
     thisParameter;
     target;
+    returnType;
     constructor(data, project, objectRegistry) {
         this.id = data.id;
         this.flags = data.flags;
@@ -1631,6 +3064,7 @@ export class Signature {
         this.parameters = data.parameters ?? [];
         this.thisParameter = data.thisParameter;
         this.target = data.target;
+        this.returnType = false;
     }
     async getTypeParameters() {
         return this.objectRegistry.fetchTypes(this, "getTypeParametersOfSignature", this.typeParameters);
@@ -1644,6 +3078,14 @@ export class Signature {
     async getTarget() {
         return this.objectRegistry.fetchSignature(this, "getTargetOfSignature", this.target);
     }
+    async getReturnType() {
+        const result = await this.objectRegistry.fetchType(this, "getReturnTypeOfSignature", this.returnType);
+        this.returnType = result.id;
+        return result;
+    }
+    getTypeParameterAtPosition(pos) {
+        return this.objectRegistry.fetchTypeParameterAtPosition(this, pos);
+    }
     get hasRestParameter() {
         return (this.flags & SignatureFlags.HasRestParameter) !== 0;
     }