typescript 7.1.0-dev.20260828.1 → 7.1.0-dev.20260829.1

package/dist/api/sync/api.js

@@ -4,7 +4,9 @@ import { CompletionItemKind } from "#enums/completionItemKind";
 import { DiagnosticCategory } from "#enums/diagnosticCategory";
 import { ElementFlags } from "#enums/elementFlags";
 import { EmitOnly } from "#enums/emitOnly";
+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";
@@ -25,7 +27,7 @@ import { SourceFileCache } from "../sourceFileCache.js";
 import { Client, } from "./client.js";
 export { formatDiagnostics, formatDiagnosticsWithColorAndContext } from "../diagnosticFormatter.js";
 export { documentURIToFileName, fileNameToDocumentURI } from "../path.js";
-export { CheckFlags, CompletionItemKind, DiagnosticCategory, ElementFlags, EmitOnly, ModifierFlags, ModuleKind, NodeBuilderFlags, ObjectFlags, SignatureFlags, SignatureKind, SymbolFlags, TypeFlags, TypeFormatFlags, TypePredicateKind };
+export { CheckFlags, CompletionItemKind, DiagnosticCategory, ElementFlags, EmitOnly, JsxEmit, ModifierFlags, ModuleKind, ModuleResolutionKind, NodeBuilderFlags, ObjectFlags, SignatureFlags, SignatureKind, SymbolFlags, TypeFlags, TypeFormatFlags, TypePredicateKind };
 export { all } from "./generatorSupport.js";
 import { all, } from "./generatorSupport.js";
 export class API {
@@ -158,12 +160,12 @@ export class API {
     }
     get transpileModuleFromFile() {
         const owner = this;
-        return cacheGeneratorMethod(owner, "transpileModuleFromFile", function (fileName, options = {}) {
+        return cacheGeneratorMethod(owner, "transpileModuleFromFile", function (file, options = {}) {
             owner.ensureInitialized();
-            return owner.client.apiRequest("transpileModuleFromFile", { fileName, options });
-        }, function* (fileName, options = {}) {
+            return owner.client.apiRequest("transpileModuleFromFile", { fileName: resolveFileName(file), options });
+        }, function* (file, options = {}) {
             yield* owner.ensureInitialized.gen();
-            return yield* apiRequest("transpileModuleFromFile", { fileName, options });
+            return yield* apiRequest("transpileModuleFromFile", { fileName: resolveFileName(file), options });
         });
     }
     get transpileDeclaration() {
@@ -178,12 +180,12 @@ export class API {
     }
     get transpileDeclarationFromFile() {
         const owner = this;
-        return cacheGeneratorMethod(owner, "transpileDeclarationFromFile", function (fileName, options = {}) {
+        return cacheGeneratorMethod(owner, "transpileDeclarationFromFile", function (file, options = {}) {
             owner.ensureInitialized();
-            return owner.client.apiRequest("transpileDeclarationFromFile", { fileName, options });
-        }, function* (fileName, options = {}) {
+            return owner.client.apiRequest("transpileDeclarationFromFile", { fileName: resolveFileName(file), options });
+        }, function* (file, options = {}) {
             yield* owner.ensureInitialized.gen();
-            return yield* apiRequest("transpileDeclarationFromFile", { fileName, options });
+            return yield* apiRequest("transpileDeclarationFromFile", { fileName: resolveFileName(file), options });
         });
     }
     get updateSnapshot() {
@@ -335,6 +337,72 @@ export class API {
             return owner.client.resetTimingInfo();
         });
     }
+    isProgramActive(program) {
+        const project = program.getProject();
+        for (const snapshot of this.activeSnapshots) {
+            if (!snapshot.isDisposed() && snapshot.getProject(project.configFileName)?.program === program) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Creates a program from current filesystem state, or derives one from oldProgram after applying fileChanges.
+     */
+    get createProgram() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "createProgram", function (rootFiles, createProgramOptions, oldProgram, fileChanges) {
+            owner.ensureInitialized();
+            if (fileChanges && !oldProgram) {
+                throw new Error("fileChanges requires an oldProgram");
+            }
+            if (oldProgram && !owner.isProgramActive(oldProgram)) {
+                throw new Error("oldProgram must belong to this API instance and reference an active snapshot");
+            }
+            const data = owner.client.apiRequest("createProgram", {
+                rootFiles,
+                createProgramOptions,
+                ...(oldProgram ? { oldProgram: { snapshot: oldProgram.snapshotId, project: oldProgram.getProject().id } } : {}),
+                ...(fileChanges ? { fileChanges } : {}),
+            });
+            if (!data.project) {
+                throw new Error("createProgram did not return a project");
+            }
+            const snapshot = new Snapshot({ snapshot: data.snapshot, projects: [data.project] }, owner.client, owner.sourceFileCache, owner.toPath, owner, () => {
+                owner.activeSnapshots.delete(snapshot);
+                owner.sourceFileCache.releaseSnapshot(snapshot.id);
+            });
+            const program = snapshot.getProjects()[0].program;
+            program.setOwnedSnapshot(snapshot);
+            owner.activeSnapshots.add(snapshot);
+            return program;
+        }, function* (rootFiles, createProgramOptions, oldProgram, fileChanges) {
+            yield* owner.ensureInitialized.gen();
+            if (fileChanges && !oldProgram) {
+                throw new Error("fileChanges requires an oldProgram");
+            }
+            if (oldProgram && !owner.isProgramActive(oldProgram)) {
+                throw new Error("oldProgram must belong to this API instance and reference an active snapshot");
+            }
+            const data = yield* apiRequest("createProgram", {
+                rootFiles,
+                createProgramOptions,
+                ...(oldProgram ? { oldProgram: { snapshot: oldProgram.snapshotId, project: oldProgram.getProject().id } } : {}),
+                ...(fileChanges ? { fileChanges } : {}),
+            });
+            if (!data.project) {
+                throw new Error("createProgram did not return a project");
+            }
+            const snapshot = new Snapshot({ snapshot: data.snapshot, projects: [data.project] }, owner.client, owner.sourceFileCache, owner.toPath, owner, () => {
+                owner.activeSnapshots.delete(snapshot);
+                owner.sourceFileCache.releaseSnapshot(snapshot.id);
+            });
+            const program = snapshot.getProjects()[0].program;
+            program.setOwnedSnapshot(snapshot);
+            owner.activeSnapshots.add(snapshot);
+            return program;
+        });
+    }
 }
 export class InternalAPI {
     client;
@@ -1172,6 +1240,7 @@ export class LanguageService {
     }
 }
 export class Program {
+    /** @internal */
     snapshotId;
     project;
     client;
@@ -1180,6 +1249,7 @@ export class Program {
     formatDiagnosticsHost;
     decoder = new Wtf8Decoder();
     sourceFileMetadataCache = new Map();
+    ownedSnapshot;
     constructor(snapshotId, project, client, sourceFileCache, toPath, formatDiagnosticsHost) {
         this.snapshotId = snapshotId;
         this.project = project;
@@ -1197,6 +1267,27 @@ export class Program {
     getNewLine() {
         return this.project.compilerOptions.newLine === NewLineKind.CRLF ? "\r\n" : "\n";
     }
+    /** @internal */
+    setOwnedSnapshot(snapshot) {
+        this.ownedSnapshot = snapshot;
+    }
+    [globalThis.Symbol.dispose]() {
+        this.dispose();
+    }
+    get dispose() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "dispose", function () {
+            const snapshot = owner.ownedSnapshot;
+            owner.ownedSnapshot = undefined;
+            if (snapshot)
+                snapshot.dispose();
+        }, function* () {
+            const snapshot = owner.ownedSnapshot;
+            owner.ownedSnapshot = undefined;
+            if (snapshot)
+                yield* snapshot.dispose.gen();
+        });
+    }
     getCompilerOptions() {
         return this.project.compilerOptions;
     }
@@ -1273,10 +1364,10 @@ export class Program {
      */
     get getSourceFileMetadata() {
         const owner = this;
-        return cacheGeneratorMethod(owner, "getSourceFileMetadata", function (fileName) {
-            return owner.getSourceFileMetadataByPath(owner.toPath(fileName));
-        }, function* (fileName) {
-            return yield* owner.getSourceFileMetadataByPath.gen(owner.toPath(fileName));
+        return cacheGeneratorMethod(owner, "getSourceFileMetadata", function (file) {
+            return owner.getSourceFileMetadataByPath(owner.toPath(resolveFileName(file)));
+        }, function* (file) {
+            return yield* owner.getSourceFileMetadataByPath.gen(owner.toPath(resolveFileName(file)));
         });
     }
     /**
@@ -1691,6 +1782,9 @@ export class Program {
             return toEmitOutput(response);
         });
     }
+    getProject() {
+        return this.project;
+    }
 }
 function toEmitOutput(response) {
     const outputFiles = new Map();
@@ -2585,17 +2679,17 @@ export class Checker {
     get isTupleType() {
         const owner = this;
         return cacheGeneratorMethod(owner, "isTupleType", function (type) {
-            return owner.client.apiRequest("isTupleType", {
-                snapshot: owner.snapshotId,
-                project: owner.project.id,
-                type: type.id,
-            });
+            return type.isTupleType();
         }, function* (type) {
-            return yield* apiRequest("isTupleType", {
-                snapshot: owner.snapshotId,
-                project: owner.project.id,
-                type: type.id,
-            });
+            return type.isTupleType();
+        });
+    }
+    get isTupleTypeTarget() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "isTupleTypeTarget", function (type) {
+            return type.isTupleTypeTarget();
+        }, function* (type) {
+            return type.isTupleTypeTarget();
         });
     }
     /**
@@ -3368,6 +3462,7 @@ class TypeObject {
     freshType;
     regularType;
     target;
+    tupleType;
     typeParameters;
     outerTypeParameters;
     localTypeParameters;
@@ -3427,16 +3522,17 @@ 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 ?? [];
         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.texts !== undefined)
@@ -3882,7 +3978,10 @@ class TypeObject {
         return isTypeReference(this);
     }
     isTupleType() {
-        return isTupleType(this);
+        return this.tupleType;
+    }
+    isTupleTypeTarget() {
+        return this.fixedLength !== undefined;
     }
     isIndexType() {
         return isIndexType(this);
@@ -3949,7 +4048,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;