typescript 7.1.0-dev.20261001.1 → 7.1.0-dev.20261003.1

package/dist/api/sync/api.d.ts

@@ -18,9 +18,9 @@ import { SymbolOwnerKind } from "#enums/symbolOwnerKind";
 import { TypeFlags } from "#enums/typeFlags";
 import { TypeFormatFlags } from "#enums/typeFormatFlags";
 import { TypePredicateKind } from "#enums/typePredicateKind";
-import { type __String, type CallLikeExpression, type Declaration, type Expression, type FileReference, type Identifier, ModifierFlags, type NamedTupleMember, type Node, type ParameterDeclaration, type Path, type SourceFile, type StringLiteralLikeNode, type SyntaxKind, type TypeNode } from "../../ast/index.ts";
+import { type __String, type CallLikeExpression, type Declaration, type Expression, type FileReference, type Identifier, ModifierFlags, type NamedTupleMember, type Node, type ParameterDeclaration, type PathKey, type RootedDirectoryPath, type RootedFilePath, type SourceFile, type StringLiteralLikeNode, type SyntaxKind, type TypeNode } from "../../ast/index.ts";
 import type { APIOptions, LSPConnectionOptions } from "../options.ts";
-import type { BuildResponse, CleanBuildResponse, CompactSymbolReference, CompilerOptions, CompletionPreferences, ConfiguredProjectId, CreateBuildOrchestratorResponse, CreateProgramOptions as ProtocolCreateProgramOptions, CreateSnapshotParams as ProtocolCreateSnapshotParams, CreateSnapshotProgramParams as ProtocolCreateSnapshotProgramParams, CreateSnapshotResponse, CreateSourceFileOptions, Diagnostic, DocumentIdentifier, DocumentPosition, FileNotifications, InferredProjectId, LanguageServerSnapshotChanges as ProtocolLanguageServerSnapshotChanges, ModuleResolutionEntry, ModuleResolutionSpec, PackageId, ParsedCommandLine, ProjectId, ProjectReference, ProjectResponse, ProtocolSymbolResponse, ReadConfigFileResponse, ReconfigureSnapshotProgramParams as ProtocolReconfigureSnapshotProgramParams, ResolutionMode, ResolvedModule, ResolvedTypeReferenceDirective, ResolveModuleNameResult, SignaturePropertyMethod, SignatureResponse, SourceFileMetadata, StaticModuleResolution, SymbolPropertyMethod, SymbolReference, SymbolResponse, SymbolsPropertyMethod, SyntheticProjectId, TextEdit, TypeAcquisition, TypePropertyMethod, TypeResponse, TypesPropertyMethod, UserPreferences } from "../proto.ts";
+import type { BuildResponse, CleanBuildResponse, CompactSymbolReference, CompilerOptions, CompletionPreferences, ConfiguredProjectId, CreateBuildOrchestratorResponse, CreateProgramOptions as ProtocolCreateProgramOptions, CreateSnapshotParams as ProtocolCreateSnapshotParams, CreateSnapshotProgramParams as ProtocolCreateSnapshotProgramParams, CreateSnapshotResponse, CreateSourceFileOptions, Diagnostic, DocumentIdentifier, DocumentPosition, FileNotifications, InferredProjectId, LanguageServerSnapshotChanges as ProtocolLanguageServerSnapshotChanges, ModuleResolutionEntry, ModuleResolutionSpec, PackageId, ParsedCommandLine, ProjectId, ProjectReference, ProjectResponse, ProtocolSymbolResponse, RawCompilerOptions, ReadConfigFileResponse, ReconfigureSnapshotProgramParams as ProtocolReconfigureSnapshotProgramParams, ResolutionMode, ResolvedModule, ResolvedTypeReferenceDirective, ResolveModuleNameResult, SignaturePropertyMethod, SignatureResponse, SourceFileMetadata, StaticModuleResolution, SymbolPropertyMethod, SymbolReference, SymbolResponse, SymbolsPropertyMethod, SyntheticProjectId, TextEdit, TypeAcquisition, TypePropertyMethod, TypeResponse, TypesPropertyMethod, UserPreferences } from "../proto.ts";
 import { type CachedSourceFile, SourceFileCache } from "../sourceFileCache.ts";
 import type { RequestTiming, TimingAccumulators, TimingInfo } from "../timing.ts";
 import { Client, type ClientSocketOptions, type ClientSpawnOptions } from "./client.ts";
@@ -28,7 +28,7 @@ import type { AssertsIdentifierTypePredicate, AssertsThisTypePredicate, BigIntLi
 export { formatDiagnostics, formatDiagnosticsWithColorAndContext } from "../diagnosticFormatter.ts";
 export { documentURIToFileName, fileNameToDocumentURI } from "../path.ts";
 export { CheckFlags, CompletionItemKind, DiagnosticCategory, ElementFlags, EmitOnly, IndexKind, JsxEmit, ModifierFlags, ModuleKind, ModuleResolutionKind, NodeBuilderFlags, ObjectFlags, ScriptKind, SignatureFlags, SignatureKind, SymbolFlags, SymbolOwnerKind, TypeFlags, TypeFormatFlags, TypePredicateKind };
-export type { APIImportAdderAction as ImportAdderAction, APIOptions, AssertsIdentifierTypePredicate, AssertsThisTypePredicate, BigIntLiteralType, BooleanLiteralType, ClientSocketOptions, ClientSpawnOptions, CompilerOptions, CompletionEntry, CompletionInfo, CompletionOptions, CompletionPreferences, ConditionalType, ConfiguredProjectId, CreateSourceFileOptions, Diagnostic, DocumentIdentifier, DocumentPosition, EmitOutput, EmitOutputFile, EmitResult, FileNotifications, FormatDiagnosticsHost, FreshableType, GenericType, GetImportEditsForSymbolsOptions, IdentifierTypePredicate, IndexedAccessType, IndexInfo, IndexType, InferredProjectId, InterfaceType, IntersectionType, IntrinsicType, JSDocTagInfo, LiteralType, LSPConnectionOptions, MappedType, ModuleResolutionEntry, ModuleResolutionSpec, NumberLiteralType, ObjectType, PackageId, ParsedCommandLine, ProjectId, ProjectReference, ReadConfigFileResponse, RequestTiming, ResolutionMode, ResolvedModule, ResolvedTypeReferenceDirective, ResolveModuleNameResult, SourceFileMetadata, StaticModuleResolution, StringLiteralType, StringMappingType, StructuredType, SubstitutionType, SyntheticProjectId, TemplateLiteralType, TextEdit, ThisTypePredicate, TimingAccumulators, TimingInfo, TupleType, TupleTypeReference, Type, TypeAcquisition, TypeParameter, TypePredicate, TypePredicateBase, TypeReference, UnionOrIntersectionType, UnionType, UserPreferences, };
+export type { APIImportAdderAction as ImportAdderAction, APIOptions, AssertsIdentifierTypePredicate, AssertsThisTypePredicate, BigIntLiteralType, BooleanLiteralType, ClientSocketOptions, ClientSpawnOptions, CompilerOptions, CompletionEntry, CompletionInfo, CompletionOptions, CompletionPreferences, ConditionalType, ConfiguredProjectId, CreateSourceFileOptions, Diagnostic, DocumentIdentifier, DocumentPosition, EmitOutput, EmitOutputFile, EmitResult, FileNotifications, FormatDiagnosticsHost, FreshableType, GenericType, GetImportEditsForSymbolsOptions, IdentifierTypePredicate, IndexedAccessType, IndexInfo, IndexType, InferredProjectId, InterfaceType, IntersectionType, IntrinsicType, JSDocTagInfo, LiteralType, LSPConnectionOptions, MappedType, ModuleResolutionEntry, ModuleResolutionSpec, NumberLiteralType, ObjectType, PackageId, ParsedCommandLine, ProjectId, ProjectReference, RawCompilerOptions, ReadConfigFileResponse, RequestTiming, ResolutionMode, ResolvedModule, ResolvedTypeReferenceDirective, ResolveModuleNameResult, SourceFileMetadata, StaticModuleResolution, StringLiteralType, StringMappingType, StructuredType, SubstitutionType, SyntheticProjectId, TemplateLiteralType, TextEdit, ThisTypePredicate, TimingAccumulators, TimingInfo, TupleType, TupleTypeReference, Type, TypeAcquisition, TypeParameter, TypePredicate, TypePredicateBase, TypeReference, UnionOrIntersectionType, UnionType, UserPreferences, };
 export interface ModuleResolverOptions {
     moduleResolutions?: ModuleResolutionSpec | undefined;
     resolveModuleName?: ResolveModuleNameCallback | undefined;
@@ -41,8 +41,11 @@ export type InProgressSnapshot = number & {
     readonly [inProgressSnapshotBrand]: never;
 };
 export type ResolveModuleNameCallback = (moduleName: string, containingDirectory: string, resolutionMode: ResolutionMode | undefined, options: ResolveModuleNameCallbackOptions) => StaticModuleResolution | undefined;
-export type CreateProgramOptions = Omit<ProtocolCreateProgramOptions, "moduleResolver"> & {
+export type CreateProgramOptions = Omit<ProtocolCreateProgramOptions, "moduleResolver" | "projectReferences"> & {
     moduleResolver?: ModuleResolver | undefined;
+    projectReferences?: readonly (Omit<ProjectReference, "path"> & {
+        path: string;
+    })[] | undefined;
 };
 export type CreateSnapshotProgramParams = Omit<ProtocolCreateSnapshotProgramParams, "options"> & {
     options?: CreateProgramOptions | undefined;
@@ -59,7 +62,7 @@ export type LanguageServerSnapshotChanges = Omit<ProtocolLanguageServerSnapshotC
     reconfigurePrograms?: readonly ReconfigureSnapshotProgramParams[] | undefined;
 };
 export interface TranspileOptions {
-    compilerOptions?: CompilerOptions | undefined;
+    compilerOptions?: RawCompilerOptions | undefined;
     fileName?: string | undefined;
     reportDiagnostics?: boolean | undefined;
 }
@@ -71,12 +74,14 @@ export interface TranspileOutput {
 export { all, type AllAPIRequestGenerator, type AnyAPIRequestGenerator, type APIRequestGenerator, defer, type DeferredAPIRequestGenerator, type ExecutedGeneratorsResults } from "./generatorSupport.ts";
 import { type AnyAPIRequestGenerator, type ExecutedGeneratorsResults } from "./generatorSupport.ts";
 export declare class API<FromLSP extends boolean = false> implements FormatDiagnosticsHost {
-    private client;
-    private sourceFileCache;
+    /** @internal */
+    readonly client: Client;
+    /** @internal */
+    readonly sourceFileCache: SourceFileCache<Symbol>;
     private toPath;
-    private currentDirectory;
     private readonly decoder;
-    private getCanonicalFileNameWorker;
+    private currentDirectory;
+    private caseSensitivity;
     private initialized;
     private initializing;
     private activeSnapshots;
@@ -85,6 +90,14 @@ export declare class API<FromLSP extends boolean = false> implements FormatDiagn
     readonly printer: Printer;
     readonly internal: InternalAPI;
     constructor(options?: APIOptions | LSPConnectionOptions);
+    /**
+     * Looks up a remote declaration's binder symbol. Throws for synthesized or configuration ASTs.
+     */
+    get getSymbol(): {
+        (declaration: Declaration): Symbol;
+        gen(declaration: Declaration): Generator<ProtocolRequest, Symbol, ProtocolResponse["result"]>;
+    };
+    private get fetchDeclarationSymbol();
     /**
      * Create an API instance from an existing LSP connection's API session.
      * Use this when connecting to an API pipe provided by an LSP server via custom/initializeAPISession.
@@ -96,8 +109,9 @@ export declare class API<FromLSP extends boolean = false> implements FormatDiagn
     batch<T extends readonly AnyAPIRequestGenerator[]>(...requestGenerators: T): ExecutedGeneratorsResults<T>;
     private get ensureInitialized();
     private get initializeWorker();
-    getCurrentDirectory(): string;
+    getCurrentDirectory(): RootedDirectoryPath;
     getCanonicalFileName(fileName: string): string;
+    private getCaseSensitivity;
     getNewLine(): string;
     get createBuildOrchestrator(): {
         (rootNames: readonly string[], buildOrchestratorOptions: BuildOrchestratorOptions): BuildOrchestrator;
@@ -198,8 +212,8 @@ export declare class API<FromLSP extends boolean = false> implements FormatDiagn
         gen(): Generator<ProtocolRequest, void, ProtocolResponse["result"]>;
     };
     get createModuleResolver(): {
-        (compilerOptions: CompilerOptions, options?: ModuleResolverOptions): ModuleResolver;
-        gen(compilerOptions: CompilerOptions, options?: ModuleResolverOptions): Generator<ProtocolRequest, ModuleResolver, ProtocolResponse["result"]>;
+        (compilerOptions: RawCompilerOptions, options?: ModuleResolverOptions): ModuleResolver;
+        gen(compilerOptions: RawCompilerOptions, options?: ModuleResolverOptions): Generator<ProtocolRequest, ModuleResolver, ProtocolResponse["result"]>;
     };
     clearSourceFileCache(): void;
     get runWithTemporaryFileUpdate(): {
@@ -228,22 +242,26 @@ export declare class API<FromLSP extends boolean = false> implements FormatDiagn
     };
     /** Creates a program from current filesystem state. */
     get createProgram(): {
-        (rootFiles: readonly DocumentIdentifier[], compilerOptions: CompilerOptions, createProgramOptions?: CreateProgramOptions): Program;
-        gen(rootFiles: readonly DocumentIdentifier[], compilerOptions: CompilerOptions, createProgramOptions?: CreateProgramOptions): Generator<ProtocolRequest, Program, ProtocolResponse["result"]>;
+        (rootFiles: readonly DocumentIdentifier[], compilerOptions: RawCompilerOptions, createProgramOptions?: CreateProgramOptions): Program;
+        gen(rootFiles: readonly DocumentIdentifier[], compilerOptions: RawCompilerOptions, createProgramOptions?: CreateProgramOptions): Generator<ProtocolRequest, Program, ProtocolResponse["result"]>;
     };
 }
 type EnsureInitialized = (() => void) & {
     gen(): Generator<ProtocolRequest, void, ProtocolResponse["result"]>;
 };
+/** Looks up a remote declaration's binder symbol through its API. Throws for non-remote declarations. */
+export declare function getSymbol(declaration: Declaration): Symbol;
+export declare namespace getSymbol {
+    function gen(declaration: Declaration): Generator<ProtocolRequest, Symbol, ProtocolResponse["result"]>;
+}
 /** An independently retained source file and its disposable remote-lifetime lease. */
 export declare class RetainedSourceFile {
     readonly sourceFile: SourceFile;
     private readonly lease;
-    private readonly client;
     private readonly onDispose;
     private disposed;
     private disposePromise;
-    constructor(sourceFile: SourceFile, lease: number, client: Client, onDispose: () => void);
+    constructor(sourceFile: SourceFile, lease: number, onDispose: () => void);
     [globalThis.Symbol.dispose](): void;
     get dispose(): {
         (): void;
@@ -261,12 +279,12 @@ export declare class InternalAPI {
         gen(dir: string): Generator<ProtocolRequest, void, ProtocolResponse["result"]>;
     };
     get stopCPUProfile(): {
-        (): string;
-        gen(): Generator<ProtocolRequest, string, ProtocolResponse["result"]>;
+        (): RootedFilePath;
+        gen(): Generator<ProtocolRequest, RootedFilePath, ProtocolResponse["result"]>;
     };
     get saveHeapProfile(): {
-        (dir: string): string;
-        gen(dir: string): Generator<ProtocolRequest, string, ProtocolResponse["result"]>;
+        (dir: string): RootedFilePath;
+        gen(dir: string): Generator<ProtocolRequest, RootedFilePath, ProtocolResponse["result"]>;
     };
 }
 type SnapshotUpdater = ((params: CreateSnapshotParams) => Snapshot) & {
@@ -321,7 +339,7 @@ export declare class Snapshot {
     readonly operation: SnapshotOperation;
     private projectMap;
     private toPath;
-    private client;
+    private readonly api;
     private disposed;
     private disposePromise;
     private onDispose;
@@ -329,7 +347,8 @@ export declare class Snapshot {
     private projectDataMap;
     private updateSnapshot;
     readonly internal: SnapshotInternalAPI;
-    constructor(data: CreateSnapshotResponse, client: Client, sourceFileCache: SourceFileCache<Symbol>, toPath: (fileName: string) => Path, formatDiagnosticsHost: FormatDiagnosticsHost, onDispose: () => void, updateSnapshot: SnapshotUpdater, baseSnapshot?: Snapshot);
+    private get client();
+    constructor(data: CreateSnapshotResponse, toPath: (fileName: string, basePath?: string) => PathKey, api: API<boolean>, onDispose: () => void, updateSnapshot: SnapshotUpdater, baseSnapshot?: Snapshot);
     getProjects(): readonly Project[];
     getConfiguredProject(configFileName: string): Project<ConfiguredProjectId> | undefined;
     getProject<Id extends ProjectId>(projectId: Id): Project<Id> | undefined;
@@ -393,15 +412,15 @@ declare class SnapshotObjectRegistry {
     clear(): void;
 }
 declare class ProjectObjectRegistry {
-    private client;
     private snapshotId;
     readonly project: Project;
     private snapshotRegistry;
-    private sourceFileCache;
     private types;
     private signatures;
     private disposed;
-    constructor(client: Client, snapshotId: number, project: Project, snapshotRegistry: SnapshotObjectRegistry, sourceFileCache: SourceFileCache<Symbol>);
+    private get client();
+    private get sourceFileCache();
+    constructor(snapshotId: number, project: Project, snapshotRegistry: SnapshotObjectRegistry);
     getOrCreateSymbol(data: ProtocolSymbolResponse): Symbol;
     /** Find an already-interned symbol and retain its file record for this registry. */
     getCachedSymbol(reference: CompactSymbolReference): Symbol | undefined;
@@ -467,21 +486,22 @@ declare class ProjectObjectRegistry {
     };
 }
 export declare class Project<Id extends ProjectId = ProjectId> {
+    /** @internal */
+    readonly api: API<boolean>;
     readonly id: Id;
-    readonly configFileName: string;
-    readonly currentDirectory: string;
+    readonly configFileName: RootedFilePath | undefined;
+    readonly currentDirectory: RootedDirectoryPath;
     readonly dirty: boolean;
     readonly parsedCommandLine: ParsedCommandLine;
     /** @deprecated Use `parsedCommandLine.options`. */
     readonly compilerOptions: CompilerOptions;
     /** @deprecated Use `parsedCommandLine.fileNames`. */
-    readonly rootFiles: readonly string[];
+    readonly rootFiles: readonly RootedFilePath[];
     readonly program: Program<Id>;
     readonly checker: Checker;
     readonly languageService: LanguageService;
-    private client;
     private snapshotId;
-    constructor(data: ProjectResponse, snapshotId: number, client: Client, sourceFileCache: SourceFileCache<Symbol>, toPath: (fileName: string) => Path, formatDiagnosticsHost: FormatDiagnosticsHost, snapshotRegistry: SnapshotObjectRegistry);
+    constructor(data: ProjectResponse, snapshotId: number, toPath: (fileName: string, basePath?: string) => PathKey, api: API<boolean>, snapshotRegistry: SnapshotObjectRegistry);
     /** @deprecated Use `languageService.getImportAdderEdits`. */
     get getImportAdderEdits(): {
         (file: DocumentIdentifier, actions: readonly APIImportAdderAction[]): readonly TextEdit[];
@@ -497,9 +517,9 @@ export declare class Project<Id extends ProjectId = ProjectId> {
 export declare class LanguageService {
     private snapshotId;
     private project;
-    private client;
     private objectRegistry;
-    constructor(snapshotId: number, project: Project, client: Client, objectRegistry: ProjectObjectRegistry);
+    private get client();
+    constructor(snapshotId: number, project: Project, objectRegistry: ProjectObjectRegistry);
     get getImportAdderEdits(): {
         (file: DocumentIdentifier, actions: readonly APIImportAdderAction[]): readonly TextEdit[];
         gen(file: DocumentIdentifier, actions: readonly APIImportAdderAction[]): Generator<ProtocolRequest, readonly TextEdit[], ProtocolResponse["result"]>;
@@ -526,16 +546,15 @@ export declare class Program<Id extends ProjectId = ProjectId> implements Format
     readonly snapshotId: number;
     readonly id: Id;
     private readonly project;
-    private readonly client;
-    private readonly sourceFileCache;
     private readonly toPath;
-    private readonly formatDiagnosticsHost;
     private readonly decoder;
     private readonly sourceFileMetadataCache;
     private ownedSnapshot;
     private disposePromise;
-    constructor(snapshotId: number, project: Project<Id>, client: Client, sourceFileCache: SourceFileCache<Symbol>, toPath: (fileName: string) => Path, formatDiagnosticsHost: FormatDiagnosticsHost);
-    getCurrentDirectory(): string;
+    private get client();
+    private get sourceFileCache();
+    constructor(snapshotId: number, project: Project<Id>, toPath: (fileName: string, basePath?: string) => PathKey);
+    getCurrentDirectory(): RootedDirectoryPath;
     getCanonicalFileName(fileName: string): string;
     getNewLine(): string;
     /** @internal */
@@ -551,6 +570,16 @@ export declare class Program<Id extends ProjectId = ProjectId> implements Format
         (file: DocumentIdentifier): SourceFile | undefined;
         gen(file: DocumentIdentifier): Generator<ProtocolRequest, SourceFile | undefined, ProtocolResponse["result"]>;
     };
+    /**
+     * Returns the source file for an already-canonical path.
+     *
+     * @internal
+     */
+    get getSourceFileByPath(): {
+        (path: PathKey): SourceFile | undefined;
+        gen(path: PathKey): Generator<ProtocolRequest, SourceFile | undefined, ProtocolResponse["result"]>;
+    };
+    private get getSourceFileWorker();
     get getResolvedModule(): {
         (file: DocumentIdentifier, moduleName: string, mode: ModuleKind): ResolvedModule | undefined;
         gen(file: DocumentIdentifier, moduleName: string, mode: ModuleKind): Generator<ProtocolRequest, ResolvedModule | undefined, ProtocolResponse["result"]>;
@@ -576,8 +605,8 @@ export declare class Program<Id extends ProjectId = ProjectId> implements Format
         gen(typeReferenceDirective: FileReference, sourceFile: DocumentIdentifier): Generator<ProtocolRequest, ResolvedTypeReferenceDirective | undefined, ProtocolResponse["result"]>;
     };
     get getSourceFileNames(): {
-        (): readonly string[];
-        gen(): Generator<ProtocolRequest, readonly string[], ProtocolResponse["result"]>;
+        (): readonly RootedFilePath[];
+        gen(): Generator<ProtocolRequest, readonly RootedFilePath[], ProtocolResponse["result"]>;
     };
     /**
      * Returns program-stored metadata for the given source file, or `undefined` if the file
@@ -595,10 +624,11 @@ export declare class Program<Id extends ProjectId = ProjectId> implements Format
      * this `Program` instance.
      */
     get getSourceFileMetadataByPath(): {
-        (path: Path): SourceFileMetadata | undefined;
-        gen(path: Path): Generator<ProtocolRequest, SourceFileMetadata | undefined, ProtocolResponse["result"]>;
+        (path: PathKey): SourceFileMetadata | undefined;
+        gen(path: PathKey): Generator<ProtocolRequest, SourceFileMetadata | undefined, ProtocolResponse["result"]>;
     };
     private get fetchSourceFileMetadata();
+    private pathKeyForFileName;
     /**
      * 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
@@ -622,8 +652,8 @@ export declare class Program<Id extends ProjectId = ProjectId> implements Format
      * Includes the root config file and any extended config files.
      */
     get getConfigFileNames(): {
-        (): readonly string[];
-        gen(): Generator<ProtocolRequest, readonly string[], ProtocolResponse["result"]>;
+        (): readonly RootedFilePath[];
+        gen(): Generator<ProtocolRequest, readonly RootedFilePath[], ProtocolResponse["result"]>;
     };
     /**
      * Get a config source file by file name/URI.
@@ -779,12 +809,35 @@ export declare class BuildOrchestrator {
 export declare class Checker {
     private snapshotId;
     private project;
-    private client;
     private objectRegistry;
     private wellKnownSymbols;
     private wellKnownSignatures;
-    constructor(snapshotId: number, project: Project, client: Client, objectRegistry: ProjectObjectRegistry);
+    private get client();
+    constructor(snapshotId: number, project: Project, objectRegistry: ProjectObjectRegistry);
     dispose(): void;
+    /** Get the merged symbol, or the original symbol if it has not been merged. */
+    get getMergedSymbol(): {
+        (symbol: Symbol): Symbol;
+        gen(symbol: Symbol): Generator<ProtocolRequest, Symbol, ProtocolResponse["result"]>;
+    };
+    /**
+     * Get a node's merged symbol. For a declaration, prefer
+     * {@link Checker.getSymbolOfDeclaration} for a non-nullable result.
+     */
+    get getSymbolOfNode(): {
+        (node: Node): Symbol | undefined;
+        gen(node: Node): Generator<ProtocolRequest, Symbol | undefined, ProtocolResponse["result"]>;
+    };
+    /** Get a declaration's merged symbol. */
+    get getSymbolOfDeclaration(): {
+        (node: Declaration): Symbol;
+        gen(node: Declaration): Generator<ProtocolRequest, Symbol, ProtocolResponse["result"]>;
+    };
+    /** Get a symbol's merged parent, if any. */
+    get getParentOfSymbol(): {
+        (symbol: Symbol): Symbol | undefined;
+        gen(symbol: Symbol): Generator<ProtocolRequest, Symbol | undefined, ProtocolResponse["result"]>;
+    };
     get getSymbolAtLocation(): {
         (node: Node): Symbol | undefined;
         (nodes: readonly Node[]): (Symbol | undefined)[];
@@ -1286,7 +1339,7 @@ export declare class NodeHandle<out T extends Node = Node> {
     private readonly fileOwner;
     readonly index: number;
     readonly kind: SyntaxKind;
-    readonly path: Path;
+    readonly path: PathKey;
     constructor(handle: string, canonicalProject: Project | undefined, fileOwner?: SourceFileOwner);
     /**
      * Resolve this handle to the actual AST node by fetching the source file from a project
@@ -1316,11 +1369,10 @@ export interface SignatureUsage {
     /** The node handle for the call expression, if the reference is invoked. */
     call?: NodeHandle | undefined;
 }
-/** A cached source-file record and the dependencies needed to materialize or extend it. */
+/** A cached source-file record and its owning API. */
 interface SourceFileOwner {
     readonly record: CachedSourceFile<Symbol>;
-    readonly cache: SourceFileCache<Symbol>;
-    readonly client: Client;
+    readonly api: API<boolean>;
 }
 type SymbolStorage = {
     readonly kind: typeof SymbolOwnerKind.File;