@typescript/native-preview 7.0.0-dev.20260701.1 → 7.0.0-dev.20260703.1

package/dist/api/sync/api.js

@@ -26,8 +26,8 @@ import { createGetCanonicalFileName, toPath, } from "../path.js";
 import { resolveFileName, toUpdateSnapshotRequest, } from "../proto.js";
 import { SourceFileCache } from "../sourceFileCache.js";
 import { Client, } from "./client.js";
-export { CompletionItemKind, DiagnosticCategory, ElementFlags, ModifierFlags, ModuleKind, NodeBuilderFlags, ObjectFlags, SignatureFlags, SignatureKind, SymbolFlags, TypeFlags, TypePredicateKind };
 export { documentURIToFileName, fileNameToDocumentURI } from "../path.js";
+export { CompletionItemKind, DiagnosticCategory, ElementFlags, ModifierFlags, ModuleKind, NodeBuilderFlags, ObjectFlags, SignatureFlags, SignatureKind, SymbolFlags, TypeFlags, TypePredicateKind };
 export class API {
     client;
     sourceFileCache;
@@ -100,6 +100,24 @@ export class API {
     clearSourceFileCache() {
         this.sourceFileCache.clear();
     }
+    /**
+     * Returns a snapshot of collected timing information for requests made
+     * through this API instance: client-measured round-trip latency and bytes
+     * transferred, folded together with the server's own per-request processing
+     * time and an estimated transport overhead (round-trip minus server time).
+     *
+     * 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.
+     */
+    getTimingInfo() {
+        return this.client.getTimingInfo();
+    }
+    /** Clears all accumulated timing totals and recent-request history, on both the client and the server. */
+    resetTimingInfo() {
+        return this.client.resetTimingInfo();
+    }
 }
 export class InternalAPI {
     client;
@@ -137,8 +155,8 @@ export class Snapshot {
         this.client = client;
         this.toPath = toPath;
         this.onDispose = onDispose;
-        this.snapshotRegistry = new SnapshotObjectRegistry(client, this.id);
         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);
@@ -190,9 +208,15 @@ class SnapshotObjectRegistry {
     symbols = new Map();
     client;
     snapshotId;
-    constructor(client, snapshotId) {
+    resolveProject;
+    constructor(client, snapshotId, resolveProject) {
         this.client = client;
         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);
     }
     getOrCreateSymbol(data) {
         let symbol = this.symbols.get(data.id);
@@ -252,14 +276,14 @@ class SnapshotObjectRegistry {
 class ProjectObjectRegistry {
     client;
     snapshotId;
-    projectId;
+    project;
     snapshotRegistry;
     types = new Map();
     signatures = new Map();
-    constructor(client, snapshotId, projectId, snapshotRegistry) {
+    constructor(client, snapshotId, project, snapshotRegistry) {
         this.client = client;
         this.snapshotId = snapshotId;
-        this.projectId = projectId;
+        this.project = project;
         this.snapshotRegistry = snapshotRegistry;
     }
     getOrCreateSymbol(data) {
@@ -282,7 +306,7 @@ class ProjectObjectRegistry {
     getOrCreateSignature(data) {
         let sig = this.signatures.get(data.id);
         if (!sig) {
-            sig = new Signature(data, this);
+            sig = new Signature(data, this.project, this);
             this.signatures.set(data.id, sig);
         }
         return sig;
@@ -304,7 +328,7 @@ class ProjectObjectRegistry {
         }
         const data = this.client.apiRequest(method, {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             objectId: source.id,
         });
         if (!data)
@@ -312,7 +336,7 @@ class ProjectObjectRegistry {
         return this.getOrCreateType(data);
     }
     fetchSymbol(source, method, handle) {
-        return this.snapshotRegistry.fetchSymbol(source, method, handle, this.projectId);
+        return this.snapshotRegistry.fetchSymbol(source, method, handle, this.project.id);
     }
     fetchSignature(source, method, handle) {
         if (!handle)
@@ -322,7 +346,7 @@ class ProjectObjectRegistry {
             return cached;
         const data = this.client.apiRequest(method, {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             objectId: source.id,
         });
         if (!data)
@@ -346,7 +370,7 @@ class ProjectObjectRegistry {
         }
         const typesData = this.client.apiRequest(method, {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             objectId: source.id,
         });
         if (typesData == null)
@@ -355,14 +379,14 @@ class ProjectObjectRegistry {
             return typesData.map(data => this.getOrCreateType(data));
     }
     fetchSymbols(source, method, handles) {
-        return this.snapshotRegistry.fetchSymbols(source, method, handles, this.projectId);
+        return this.snapshotRegistry.fetchSymbols(source, method, handles, this.project.id);
     }
     // getBaseTypes is a checker-level endpoint keyed by `type` (not `objectId`),
     // so it cannot go through fetchTypes. This helper reuses that server method.
     fetchBaseTypes(source) {
         const typesData = this.client.apiRequest("getBaseTypes", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: source.id,
         });
         if (typesData == null)
@@ -385,9 +409,9 @@ export class Project {
         this.compilerOptions = data.compilerOptions;
         this.rootFiles = data.rootFiles;
         this.client = client;
-        this.program = new Program(snapshotId, this.id, client, sourceFileCache, toPath);
-        const objectRegistry = new ProjectObjectRegistry(client, snapshotId, this.id, snapshotRegistry);
-        this.checker = new Checker(snapshotId, this.id, client, objectRegistry);
+        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);
     }
     dispose() {
@@ -396,31 +420,34 @@ export class Project {
 }
 export class Program {
     snapshotId;
-    projectId;
+    project;
     client;
     sourceFileCache;
     toPath;
     decoder = new Wtf8Decoder();
     sourceFileMetadataCache = new Map();
-    constructor(snapshotId, projectId, client, sourceFileCache, toPath) {
+    constructor(snapshotId, project, client, sourceFileCache, toPath) {
         this.snapshotId = snapshotId;
-        this.projectId = projectId;
+        this.project = project;
         this.client = client;
         this.sourceFileCache = sourceFileCache;
         this.toPath = toPath;
     }
+    getCompilerOptions() {
+        return this.project.compilerOptions;
+    }
     getSourceFile(file) {
         const fileName = resolveFileName(file);
         const path = this.toPath(fileName);
         // Check if we already have a retained cache entry for this (snapshot, project) pair
-        const retained = this.sourceFileCache.getRetained(path, this.snapshotId, this.projectId);
+        const retained = this.sourceFileCache.getRetained(path, this.snapshotId, this.project.id);
         if (retained) {
             return retained;
         }
         // Fetch from server
         const binaryData = this.client.apiRequestBinary("getSourceFile", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             file,
         });
         if (!binaryData) {
@@ -430,13 +457,13 @@ export class Program {
         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);
-        return this.sourceFileCache.set(path, sourceFile, parseOptionsKey, contentHash, this.snapshotId, this.projectId);
+        const sourceFile = new RemoteSourceFile(binaryData, this.decoder, this.client.getTimingCollector());
+        return this.sourceFileCache.set(path, sourceFile, parseOptionsKey, contentHash, this.snapshotId, this.project.id);
     }
     getSourceFileNames() {
         const data = this.client.apiRequest("getSourceFileNames", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
         });
         return data ?? [];
     }
@@ -465,7 +492,7 @@ export class Program {
     fetchSourceFileMetadata(path) {
         const data = this.client.apiRequest("getSourceFileMetadata", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             file: path,
         });
         return data ?? undefined;
@@ -495,7 +522,7 @@ export class Program {
     getSyntacticDiagnostics(file) {
         const data = this.client.apiRequest("getSyntacticDiagnostics", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             ...(file !== undefined ? { file } : {}),
         });
         return data ?? [];
@@ -507,7 +534,7 @@ export class Program {
     getBindDiagnostics(file) {
         const data = this.client.apiRequest("getBindDiagnostics", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             ...(file !== undefined ? { file } : {}),
         });
         return data ?? [];
@@ -519,7 +546,7 @@ export class Program {
     getSemanticDiagnostics(file) {
         const data = this.client.apiRequest("getSemanticDiagnostics", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             ...(file !== undefined ? { file } : {}),
         });
         return data ?? [];
@@ -531,7 +558,7 @@ export class Program {
     getSuggestionDiagnostics(file) {
         const data = this.client.apiRequest("getSuggestionDiagnostics", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             ...(file !== undefined ? { file } : {}),
         });
         return data ?? [];
@@ -543,7 +570,7 @@ export class Program {
     getDeclarationDiagnostics(file) {
         const data = this.client.apiRequest("getDeclarationDiagnostics", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             ...(file !== undefined ? { file } : {}),
         });
         return data ?? [];
@@ -554,7 +581,7 @@ export class Program {
     getProgramDiagnostics() {
         const data = this.client.apiRequest("getProgramDiagnostics", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
         });
         return data ?? [];
     }
@@ -564,7 +591,7 @@ export class Program {
     getGlobalDiagnostics() {
         const data = this.client.apiRequest("getGlobalDiagnostics", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
         });
         return data ?? [];
     }
@@ -574,20 +601,20 @@ export class Program {
     getConfigFileParsingDiagnostics() {
         const data = this.client.apiRequest("getConfigFileParsingDiagnostics", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
         });
         return data ?? [];
     }
 }
 export class Checker {
     snapshotId;
-    projectId;
+    project;
     client;
     objectRegistry;
     wellKnownSymbols;
-    constructor(snapshotId, projectId, client, objectRegistry) {
+    constructor(snapshotId, project, client, objectRegistry) {
         this.snapshotId = snapshotId;
-        this.projectId = projectId;
+        this.project = project;
         this.client = client;
         this.objectRegistry = objectRegistry;
     }
@@ -598,14 +625,14 @@ export class Checker {
         if (Array.isArray(nodeOrNodes)) {
             const data = this.client.apiRequest("getSymbolsAtLocations", {
                 snapshot: this.snapshotId,
-                project: this.projectId,
+                project: this.project.id,
                 locations: nodeOrNodes.map(node => getNodeId(node)),
             });
             return data.map(d => d ? this.objectRegistry.getOrCreateSymbol(d) : undefined);
         }
         const data = this.client.apiRequest("getSymbolAtLocation", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(nodeOrNodes),
         });
         return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
@@ -614,7 +641,7 @@ export class Checker {
         if (typeof positionOrPositions === "number") {
             const data = this.client.apiRequest("getSymbolAtPosition", {
                 snapshot: this.snapshotId,
-                project: this.projectId,
+                project: this.project.id,
                 file,
                 position: positionOrPositions,
             });
@@ -622,7 +649,7 @@ export class Checker {
         }
         const data = this.client.apiRequest("getSymbolsAtPositions", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             file,
             positions: positionOrPositions,
         });
@@ -632,14 +659,14 @@ export class Checker {
         if (Array.isArray(symbolOrSymbols)) {
             const data = this.client.apiRequest("getTypesOfSymbols", {
                 snapshot: this.snapshotId,
-                project: this.projectId,
+                project: this.project.id,
                 symbols: symbolOrSymbols.map(s => s.id),
             });
             return data.map(d => d ? this.objectRegistry.getOrCreateType(d) : undefined);
         }
         const data = this.client.apiRequest("getTypeOfSymbol", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             symbol: symbolOrSymbols.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -652,7 +679,7 @@ export class Checker {
     getDeclaredTypeOfSymbol(symbol) {
         const data = this.client.apiRequest("getDeclaredTypeOfSymbol", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             symbol: symbol.id,
         });
         if (!data)
@@ -662,40 +689,40 @@ export class Checker {
     getReferencesToSymbolInFile(file, symbol) {
         const data = this.client.apiRequest("getReferencesToSymbolInFile", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             file,
             symbol: symbol.id,
         });
-        return (data ?? []).map(h => new NodeHandle(h));
+        return (data ?? []).map(h => new NodeHandle(h, this.project));
     }
     getReferencedSymbolsForNode(node, position) {
         const data = this.client.apiRequest("getReferencedSymbolsForNode", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             node: getNodeId(node),
             position,
         });
         return (data ?? []).map(entry => ({
-            definition: new NodeHandle(entry.definition),
+            definition: new NodeHandle(entry.definition, this.project),
             symbol: entry.symbol ? this.objectRegistry.getOrCreateSymbol(entry.symbol) : undefined,
-            references: (entry.references ?? []).map(h => new NodeHandle(h)),
+            references: (entry.references ?? []).map(h => new NodeHandle(h, this.project)),
         }));
     }
     getSignatureUsage(signatureDecl) {
         const data = this.client.apiRequest("getSignatureUsages", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             signatureDecl: getNodeId(signatureDecl),
         });
         return (data ?? []).map(entry => ({
-            name: new NodeHandle(entry.name),
-            call: entry.call ? new NodeHandle(entry.call) : undefined,
+            name: new NodeHandle(entry.name, this.project),
+            call: entry.call ? new NodeHandle(entry.call, this.project) : undefined,
         }));
     }
     getCompletionsAtPosition(document, position, options) {
         const data = this.client.apiRequest("getCompletionsAtPosition", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             file: document,
             position,
             triggerCharacter: options?.triggerCharacter,
@@ -715,14 +742,14 @@ export class Checker {
         if (Array.isArray(nodeOrNodes)) {
             const data = this.client.apiRequest("getTypeAtLocations", {
                 snapshot: this.snapshotId,
-                project: this.projectId,
+                project: this.project.id,
                 locations: nodeOrNodes.map(node => getNodeId(node)),
             });
             return data.map(d => d ? this.objectRegistry.getOrCreateType(d) : undefined);
         }
         const data = this.client.apiRequest("getTypeAtLocation", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(nodeOrNodes),
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -730,7 +757,7 @@ export class Checker {
     getSignaturesOfType(type, kind) {
         const data = this.client.apiRequest("getSignaturesOfType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
             kind,
         });
@@ -739,7 +766,7 @@ export class Checker {
     getResolvedSignature(node) {
         const data = this.client.apiRequest("getResolvedSignature", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(node),
         });
         return data ? this.objectRegistry.getOrCreateSignature(data) : undefined;
@@ -748,7 +775,7 @@ export class Checker {
         if (typeof positionOrPositions === "number") {
             const data = this.client.apiRequest("getTypeAtPosition", {
                 snapshot: this.snapshotId,
-                project: this.projectId,
+                project: this.project.id,
                 file,
                 position: positionOrPositions,
             });
@@ -756,7 +783,7 @@ export class Checker {
         }
         const data = this.client.apiRequest("getTypesAtPositions", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             file,
             positions: positionOrPositions,
         });
@@ -767,7 +794,7 @@ export class Checker {
         const isNode = location && "kind" in location;
         const data = this.client.apiRequest("resolveName", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             name,
             meaning,
             location: isNode ? getNodeId(location) : undefined,
@@ -786,7 +813,7 @@ export class Checker {
     getContextualType(node) {
         const data = this.client.apiRequest("getContextualType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(node),
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -794,7 +821,7 @@ export class Checker {
     getBaseTypeOfLiteralType(type) {
         const data = this.client.apiRequest("getBaseTypeOfLiteralType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -802,7 +829,7 @@ export class Checker {
     getNonNullableType(type) {
         const data = this.client.apiRequest("getNonNullableType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -810,7 +837,7 @@ export class Checker {
     getTypeFromTypeNode(node) {
         const data = this.client.apiRequest("getTypeFromTypeNode", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(node),
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -818,7 +845,7 @@ export class Checker {
     getWidenedType(type) {
         const data = this.client.apiRequest("getWidenedType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -826,7 +853,7 @@ export class Checker {
     getParameterType(signature, index) {
         const data = this.client.apiRequest("getParameterType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             signature: signature.id,
             index,
         });
@@ -835,14 +862,14 @@ export class Checker {
     isArrayLikeType(type) {
         return this.client.apiRequest("isArrayLikeType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
     }
     isTypeAssignableTo(source, target) {
         return this.client.apiRequest("isTypeAssignableTo", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             source: source.id,
             target: target.id,
         });
@@ -850,7 +877,7 @@ export class Checker {
     getShorthandAssignmentValueSymbol(node) {
         const data = this.client.apiRequest("getShorthandAssignmentValueSymbol", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(node),
         });
         return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
@@ -863,7 +890,7 @@ export class Checker {
     getTypeOfSymbolAtLocation(symbol, location) {
         const data = this.client.apiRequest("getTypeOfSymbolAtLocation", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             symbol: symbol.id,
             location: getNodeId(location),
         });
@@ -874,7 +901,7 @@ export class Checker {
     getIntrinsicType(method) {
         const data = this.client.apiRequest(method, {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
         });
         return this.objectRegistry.getOrCreateType(data);
     }
@@ -914,7 +941,7 @@ export class Checker {
     typeToTypeNode(type, enclosingDeclaration, flags) {
         const binaryData = this.client.apiRequestBinary("typeToTypeNode", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
             location: enclosingDeclaration ? getNodeId(enclosingDeclaration) : undefined,
             flags,
@@ -926,7 +953,7 @@ export class Checker {
     signatureToSignatureDeclaration(signature, kind, enclosingDeclaration, flags) {
         const binaryData = this.client.apiRequestBinary("signatureToSignatureDeclaration", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             signature: signature.id,
             kind,
             location: enclosingDeclaration ? getNodeId(enclosingDeclaration) : undefined,
@@ -939,7 +966,7 @@ export class Checker {
     typeToString(type, enclosingDeclaration, flags) {
         return this.client.apiRequest("typeToString", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
             location: enclosingDeclaration ? getNodeId(enclosingDeclaration) : undefined,
             flags,
@@ -948,28 +975,28 @@ export class Checker {
     isContextSensitive(node) {
         return this.client.apiRequest("isContextSensitive", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(node),
         });
     }
     isArrayType(type) {
         return this.client.apiRequest("isArrayType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
     }
     isTupleType(type) {
         return this.client.apiRequest("isTupleType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
     }
     getReturnTypeOfSignature(signature) {
         const data = this.client.apiRequest("getReturnTypeOfSignature", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             signature: signature.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -977,7 +1004,7 @@ export class Checker {
     getRestTypeOfSignature(signature) {
         const data = this.client.apiRequest("getRestTypeOfSignature", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             signature: signature.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -985,7 +1012,7 @@ export class Checker {
     getTypePredicateOfSignature(signature) {
         const data = this.client.apiRequest("getTypePredicateOfSignature", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             signature: signature.id,
         });
         if (!data)
@@ -1004,7 +1031,7 @@ export class Checker {
     getBaseTypes(type) {
         const data = this.client.apiRequest("getBaseTypes", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         return data ? data.map(d => this.objectRegistry.getOrCreateType(d)) : [];
@@ -1012,7 +1039,7 @@ export class Checker {
     getApparentType(type) {
         const data = this.client.apiRequest("getApparentType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -1020,7 +1047,7 @@ export class Checker {
     getPropertiesOfType(type) {
         const data = this.client.apiRequest("getPropertiesOfType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         return data ? data.map(d => this.objectRegistry.getOrCreateSymbol(d)) : [];
@@ -1028,7 +1055,7 @@ export class Checker {
     getIndexInfosOfType(type) {
         const data = this.client.apiRequest("getIndexInfosOfType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         if (!data)
@@ -1037,7 +1064,7 @@ export class Checker {
             keyType: this.objectRegistry.getOrCreateType(d.keyType),
             valueType: this.objectRegistry.getOrCreateType(d.valueType),
             isReadonly: d.isReadonly ?? false,
-            declaration: d.declaration ? new NodeHandle(d.declaration) : undefined,
+            declaration: d.declaration ? new NodeHandle(d.declaration, this.project) : undefined,
         }));
     }
     /**
@@ -1047,7 +1074,7 @@ export class Checker {
     getConstraintOfTypeParameter(type) {
         const data = this.client.apiRequest("getConstraintOfTypeParameter", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -1055,7 +1082,7 @@ export class Checker {
     getBaseConstraintOfType(type) {
         const data = this.client.apiRequest("getBaseConstraintOfType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         return data ? this.objectRegistry.getOrCreateType(data) : undefined;
@@ -1063,7 +1090,7 @@ export class Checker {
     getPropertyOfType(type, name) {
         const data = this.client.apiRequest("getPropertyOfType", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
             name,
         });
@@ -1072,7 +1099,7 @@ export class Checker {
     getConstantValue(node) {
         const data = this.client.apiRequest("getConstantValue", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(node),
         });
         return data ?? undefined;
@@ -1080,7 +1107,7 @@ export class Checker {
     getSignatureFromDeclaration(node) {
         const data = this.client.apiRequest("getSignatureFromDeclaration", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(node),
         });
         return data ? this.objectRegistry.getOrCreateSignature(data) : undefined;
@@ -1088,7 +1115,7 @@ export class Checker {
     getExportSpecifierLocalTargetSymbol(node) {
         const data = this.client.apiRequest("getExportSpecifierLocalTargetSymbol", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             location: getNodeId(node),
         });
         return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
@@ -1101,7 +1128,7 @@ export class Checker {
     getAliasedSymbol(symbol) {
         const data = this.client.apiRequest("getAliasedSymbol", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             symbol: symbol.id,
         });
         if (!data)
@@ -1111,7 +1138,7 @@ export class Checker {
     getImmediateAliasedSymbol(symbol) {
         const data = this.client.apiRequest("getImmediateAliasedSymbol", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             symbol: symbol.id,
         });
         return data ? this.objectRegistry.getOrCreateSymbol(data) : undefined;
@@ -1125,7 +1152,7 @@ export class Checker {
     getWellKnownSymbols() {
         return this.wellKnownSymbols ??= this.client.apiRequest("getWellKnownSymbols", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
         });
     }
     /**
@@ -1150,7 +1177,7 @@ export class Checker {
     getExportsOfModule(symbol) {
         const data = this.client.apiRequest("getExportsOfModule", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             symbol: symbol.id,
         });
         return data ? data.map(d => this.objectRegistry.getOrCreateSymbol(d)) : [];
@@ -1158,7 +1185,7 @@ export class Checker {
     getMemberInModuleExports(symbol, name) {
         const data = this.client.apiRequest("getMemberInModuleExports", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             symbol: symbol.id,
             name,
         });
@@ -1167,7 +1194,7 @@ export class Checker {
     getJsDocTagsOfSymbol(symbol) {
         const data = this.client.apiRequest("getJsDocTags", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             symbol: symbol.id,
         });
         return data ?? [];
@@ -1175,7 +1202,7 @@ export class Checker {
     getDocumentationCommentOfSymbol(symbol) {
         return this.client.apiRequest("getDocumentationComment", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             symbol: symbol.id,
         });
     }
@@ -1185,7 +1212,7 @@ export class Checker {
     getTypeArguments(type) {
         const data = this.client.apiRequest("getTypeArguments", {
             snapshot: this.snapshotId,
-            project: this.projectId,
+            project: this.project.id,
             type: type.id,
         });
         return data ? data.map(d => this.objectRegistry.getOrCreateType(d)) : [];
@@ -1206,20 +1233,28 @@ export class Emitter {
     }
 }
 export class NodeHandle {
+    /**
+     * The project this handle was produced in, used as the default for {@link resolve}.
+     * Node handles are only meaningful within a project's program, so the producing project
+     * is remembered so callers don't have to pass it explicitly.
+     */
+    canonicalProject;
     index;
     kind;
     path;
-    constructor(handle) {
+    constructor(handle, canonicalProject) {
         const parsed = parseNodeHandle(handle);
         this.index = parsed.index;
         this.kind = parsed.kind;
         this.path = parsed.path;
+        this.canonicalProject = canonicalProject;
     }
     /**
-     * Resolve this handle to the actual AST node by fetching the source file
-     * from the given project and looking up the node by index.
+     * 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.
      */
-    resolve(project) {
+    resolve(project = this.canonicalProject) {
         const sourceFile = project.program.getSourceFile(this.path);
         if (!sourceFile) {
             return undefined;
@@ -1229,6 +1264,12 @@ export class NodeHandle {
 }
 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;
     /** The escaped (`__String`) name, used as the key in member/export tables. */
     escapedName;
@@ -1249,15 +1290,20 @@ export class Symbol {
         this.name = unescapeLeadingUnderscores(data.name);
         this.flags = data.flags;
         this.checkFlags = data.checkFlags;
-        this.declarations = (data.declarations ?? []).map(d => new NodeHandle(d));
-        this.valueDeclaration = data.valueDeclaration ? new NodeHandle(data.valueDeclaration) : undefined;
+        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;
         if (data.parent !== undefined)
             this.parent = data.parent;
         if (data.exportSymbol !== undefined)
             this.exportSymbol = data.exportSymbol;
     }
     getParent() {
-        return this.objectRegistry.fetchSymbol(this, "getParentOfSymbol", this.parent);
+        return this.objectRegistry.fetchSymbol(this, "getParentOfSymbol", this.parent, this.canonicalProject.id);
     }
     /**
      * Get this symbol's members keyed by escaped name. The result is cached on
@@ -1274,7 +1320,7 @@ export class Symbol {
         return this.exportsCache ??= this.fetchSymbolTable("getExportsOfSymbol");
     }
     fetchSymbolTable(method) {
-        const symbols = this.objectRegistry.fetchSymbols(this, method);
+        const symbols = this.objectRegistry.fetchSymbols(this, method, undefined, this.canonicalProject.id);
         const table = new Map();
         for (const symbol of symbols) {
             table.set(symbol.escapedName, symbol);
@@ -1284,7 +1330,7 @@ export class Symbol {
     getExportSymbol() {
         if (!this.exportSymbol)
             return this;
-        return this.objectRegistry.fetchSymbol(this, "getExportSymbolOfSymbol", this.exportSymbol);
+        return this.objectRegistry.fetchSymbol(this, "getExportSymbolOfSymbol", this.exportSymbol, this.canonicalProject.id);
     }
     getJsDocTags(checker) {
         return checker.getJsDocTagsOfSymbol(this);
@@ -1584,11 +1630,11 @@ export class Signature {
     parameters;
     thisParameter;
     target;
-    constructor(data, objectRegistry) {
+    constructor(data, project, objectRegistry) {
         this.id = data.id;
         this.flags = data.flags;
         this.objectRegistry = objectRegistry;
-        this.declaration = data.declaration ? new NodeHandle(data.declaration) : undefined;
+        this.declaration = data.declaration ? new NodeHandle(data.declaration, project) : undefined;
         this.typeParameters = data.typeParameters ?? [];
         this.parameters = data.parameters ?? [];
         this.thisParameter = data.thisParameter;