typescript 5.5.0-dev.20240325 → 5.5.0-dev.20240327

package/lib/tsc.js

@@ -18,7 +18,7 @@ and limitations under the License.
 
 // src/compiler/corePublic.ts
 var versionMajorMinor = "5.5";
-var version = `${versionMajorMinor}.0-dev.20240325`;
+var version = `${versionMajorMinor}.0-dev.20240327`;
 
 // src/compiler/core.ts
 var emptyArray = [];
@@ -3346,12 +3346,13 @@ var SyntaxKind = /* @__PURE__ */ ((SyntaxKind4) => {
   SyntaxKind4[SyntaxKind4["JSDocPropertyTag"] = 348] = "JSDocPropertyTag";
   SyntaxKind4[SyntaxKind4["JSDocThrowsTag"] = 349] = "JSDocThrowsTag";
   SyntaxKind4[SyntaxKind4["JSDocSatisfiesTag"] = 350] = "JSDocSatisfiesTag";
-  SyntaxKind4[SyntaxKind4["SyntaxList"] = 351] = "SyntaxList";
-  SyntaxKind4[SyntaxKind4["NotEmittedStatement"] = 352] = "NotEmittedStatement";
-  SyntaxKind4[SyntaxKind4["PartiallyEmittedExpression"] = 353] = "PartiallyEmittedExpression";
-  SyntaxKind4[SyntaxKind4["CommaListExpression"] = 354] = "CommaListExpression";
-  SyntaxKind4[SyntaxKind4["SyntheticReferenceExpression"] = 355] = "SyntheticReferenceExpression";
-  SyntaxKind4[SyntaxKind4["Count"] = 356] = "Count";
+  SyntaxKind4[SyntaxKind4["JSDocImportTag"] = 351] = "JSDocImportTag";
+  SyntaxKind4[SyntaxKind4["SyntaxList"] = 352] = "SyntaxList";
+  SyntaxKind4[SyntaxKind4["NotEmittedStatement"] = 353] = "NotEmittedStatement";
+  SyntaxKind4[SyntaxKind4["PartiallyEmittedExpression"] = 354] = "PartiallyEmittedExpression";
+  SyntaxKind4[SyntaxKind4["CommaListExpression"] = 355] = "CommaListExpression";
+  SyntaxKind4[SyntaxKind4["SyntheticReferenceExpression"] = 356] = "SyntheticReferenceExpression";
+  SyntaxKind4[SyntaxKind4["Count"] = 357] = "Count";
   SyntaxKind4[SyntaxKind4["FirstAssignment"] = 64 /* EqualsToken */] = "FirstAssignment";
   SyntaxKind4[SyntaxKind4["LastAssignment"] = 79 /* CaretEqualsToken */] = "LastAssignment";
   SyntaxKind4[SyntaxKind4["FirstCompoundAssignment"] = 65 /* PlusEqualsToken */] = "FirstCompoundAssignment";
@@ -3380,9 +3381,9 @@ var SyntaxKind = /* @__PURE__ */ ((SyntaxKind4) => {
   SyntaxKind4[SyntaxKind4["LastStatement"] = 259 /* DebuggerStatement */] = "LastStatement";
   SyntaxKind4[SyntaxKind4["FirstNode"] = 166 /* QualifiedName */] = "FirstNode";
   SyntaxKind4[SyntaxKind4["FirstJSDocNode"] = 309 /* JSDocTypeExpression */] = "FirstJSDocNode";
-  SyntaxKind4[SyntaxKind4["LastJSDocNode"] = 350 /* JSDocSatisfiesTag */] = "LastJSDocNode";
+  SyntaxKind4[SyntaxKind4["LastJSDocNode"] = 351 /* JSDocImportTag */] = "LastJSDocNode";
   SyntaxKind4[SyntaxKind4["FirstJSDocTagNode"] = 327 /* JSDocTag */] = "FirstJSDocTagNode";
-  SyntaxKind4[SyntaxKind4["LastJSDocTagNode"] = 350 /* JSDocSatisfiesTag */] = "LastJSDocTagNode";
+  SyntaxKind4[SyntaxKind4["LastJSDocTagNode"] = 351 /* JSDocImportTag */] = "LastJSDocTagNode";
   SyntaxKind4[SyntaxKind4["FirstContextualKeyword"] = 128 /* AbstractKeyword */] = "FirstContextualKeyword";
   SyntaxKind4[SyntaxKind4["LastContextualKeyword"] = 165 /* OfKeyword */] = "LastContextualKeyword";
   return SyntaxKind4;
@@ -4136,14 +4137,17 @@ function createDynamicPriorityPollingWatchFile(host) {
     pollingIntervalQueue(pollingInterval).pollScheduled = host.setTimeout(pollingInterval === 250 /* Low */ ? pollLowPollingIntervalQueue : pollPollingIntervalQueue, pollingInterval, pollingInterval === 250 /* Low */ ? "pollLowPollingIntervalQueue" : "pollPollingIntervalQueue", pollingIntervalQueue(pollingInterval));
   }
 }
-function createUseFsEventsOnParentDirectoryWatchFile(fsWatch, useCaseSensitiveFileNames2) {
+function createUseFsEventsOnParentDirectoryWatchFile(fsWatch, useCaseSensitiveFileNames2, getModifiedTime3, fsWatchWithTimestamp) {
   const fileWatcherCallbacks = createMultiMap();
+  const fileTimestamps = fsWatchWithTimestamp ? /* @__PURE__ */ new Map() : void 0;
   const dirWatchers = /* @__PURE__ */ new Map();
   const toCanonicalName = createGetCanonicalFileName(useCaseSensitiveFileNames2);
   return nonPollingWatchFile;
   function nonPollingWatchFile(fileName, callback, _pollingInterval, fallbackOptions) {
     const filePath = toCanonicalName(fileName);
-    fileWatcherCallbacks.add(filePath, callback);
+    if (fileWatcherCallbacks.add(filePath, callback).length === 1 && fileTimestamps) {
+      fileTimestamps.set(filePath, getModifiedTime3(fileName) || missingFileModifiedTime);
+    }
     const dirPath = getDirectoryPath(filePath) || ".";
     const watcher = dirWatchers.get(dirPath) || createDirectoryWatcher(getDirectoryPath(fileName) || ".", dirPath, fallbackOptions);
     watcher.referenceCount++;
@@ -4163,14 +4167,31 @@ function createUseFsEventsOnParentDirectoryWatchFile(fsWatch, useCaseSensitiveFi
     const watcher = fsWatch(
       dirName,
       1 /* Directory */,
-      (_eventName, relativeFileName, modifiedTime) => {
+      (eventName, relativeFileName) => {
         if (!isString(relativeFileName))
           return;
         const fileName = getNormalizedAbsolutePath(relativeFileName, dirName);
-        const callbacks = fileName && fileWatcherCallbacks.get(toCanonicalName(fileName));
+        const filePath = toCanonicalName(fileName);
+        const callbacks = fileName && fileWatcherCallbacks.get(filePath);
         if (callbacks) {
+          let currentModifiedTime;
+          let eventKind = 1 /* Changed */;
+          if (fileTimestamps) {
+            const existingTime = fileTimestamps.get(filePath);
+            if (eventName === "change") {
+              currentModifiedTime = getModifiedTime3(fileName) || missingFileModifiedTime;
+              if (currentModifiedTime.getTime() === existingTime.getTime())
+                return;
+            }
+            currentModifiedTime || (currentModifiedTime = getModifiedTime3(fileName) || missingFileModifiedTime);
+            fileTimestamps.set(filePath, currentModifiedTime);
+            if (existingTime === missingFileModifiedTime)
+              eventKind = 0 /* Created */;
+            else if (currentModifiedTime === missingFileModifiedTime)
+              eventKind = 2 /* Deleted */;
+          }
           for (const fileCallback of callbacks) {
-            fileCallback(fileName, 1 /* Changed */, modifiedTime);
+            fileCallback(fileName, eventKind, currentModifiedTime);
           }
         }
       },
@@ -4564,7 +4585,7 @@ function createSystemWatchFunctions({
         );
       case 5 /* UseFsEventsOnParentDirectory */:
         if (!nonPollingWatchFile) {
-          nonPollingWatchFile = createUseFsEventsOnParentDirectoryWatchFile(fsWatch, useCaseSensitiveFileNames2);
+          nonPollingWatchFile = createUseFsEventsOnParentDirectoryWatchFile(fsWatch, useCaseSensitiveFileNames2, getModifiedTime3, fsWatchWithTimestamp);
         }
         return nonPollingWatchFile(fileName, callback, pollingInterval, getFallbackOptions(options));
       default:
@@ -4739,7 +4760,7 @@ function createSystemWatchFunctions({
         return watchPresentFileSystemEntryWithFsWatchFile();
       }
       try {
-        const presentWatcher = (!fsWatchWithTimestamp ? fsWatchWorker : fsWatchWorkerHandlingTimestamp)(
+        const presentWatcher = (entryKind === 1 /* Directory */ || !fsWatchWithTimestamp ? fsWatchWorker : fsWatchWorkerHandlingTimestamp)(
           fileOrDirectory,
           recursive,
           inodeWatching ? callbackChangingToMissingFileSystemEntry : callback
@@ -4841,7 +4862,6 @@ var sys = (() => {
     }
     let activeSession;
     let profilePath = "./profile.cpuprofile";
-    const Buffer = require("buffer").Buffer;
     const isMacOs = process.platform === "darwin";
     const isLinuxOrMacOs = process.platform === "linux" || isMacOs;
     const platform = _os.platform();
@@ -4959,9 +4979,8 @@ var sys = (() => {
           handle.setBlocking(true);
         }
       },
-      bufferFrom,
-      base64decode: (input) => bufferFrom(input, "base64").toString("utf8"),
-      base64encode: (input) => bufferFrom(input).toString("base64"),
+      base64decode: (input) => Buffer.from(input, "base64").toString("utf8"),
+      base64encode: (input) => Buffer.from(input).toString("base64"),
       require: (baseDir, moduleName) => {
         try {
           const modulePath = resolveJSModule(moduleName, baseDir, nodeSystem);
@@ -5050,9 +5069,6 @@ var sys = (() => {
         return false;
       }
     }
-    function bufferFrom(input, encoding) {
-      return Buffer.from && Buffer.from !== Int8Array.from ? Buffer.from(input, encoding) : new Buffer(input, encoding);
-    }
     function isFileSystemCaseSensitive() {
       if (platform === "win32" || platform === "win64") {
         return false;
@@ -6187,7 +6203,6 @@ var Diagnostics = {
   _0_and_1_index_signatures_are_incompatible: diag(2330, 1 /* Error */, "_0_and_1_index_signatures_are_incompatible_2330", "'{0}' and '{1}' index signatures are incompatible."),
   this_cannot_be_referenced_in_a_module_or_namespace_body: diag(2331, 1 /* Error */, "this_cannot_be_referenced_in_a_module_or_namespace_body_2331", "'this' cannot be referenced in a module or namespace body."),
   this_cannot_be_referenced_in_current_location: diag(2332, 1 /* Error */, "this_cannot_be_referenced_in_current_location_2332", "'this' cannot be referenced in current location."),
-  this_cannot_be_referenced_in_constructor_arguments: diag(2333, 1 /* Error */, "this_cannot_be_referenced_in_constructor_arguments_2333", "'this' cannot be referenced in constructor arguments."),
   this_cannot_be_referenced_in_a_static_property_initializer: diag(2334, 1 /* Error */, "this_cannot_be_referenced_in_a_static_property_initializer_2334", "'this' cannot be referenced in a static property initializer."),
   super_can_only_be_referenced_in_a_derived_class: diag(2335, 1 /* Error */, "super_can_only_be_referenced_in_a_derived_class_2335", "'super' can only be referenced in a derived class."),
   super_cannot_be_referenced_in_constructor_arguments: diag(2336, 1 /* Error */, "super_cannot_be_referenced_in_constructor_arguments_2336", "'super' cannot be referenced in constructor arguments."),
@@ -8452,7 +8467,7 @@ function createScanner(languageVersion, skipTrivia2, languageVariant = 0 /* Stan
   var tokenValue;
   var tokenFlags;
   var commentDirectives;
-  var inJSDocType = 0;
+  var skipJsDocLeadingAsterisks = 0;
   var scriptKind = 0 /* Unknown */;
   var jsDocParsingMode = 0 /* ParseAll */;
   setText(text, start, length2);
@@ -8503,7 +8518,7 @@ function createScanner(languageVersion, skipTrivia2, languageVariant = 0 /* Stan
     setOnError,
     resetTokenState,
     setTextPos: resetTokenState,
-    setInJSDocType,
+    setSkipJsDocLeadingAsterisks,
     tryScan,
     lookAhead,
     scanRange
@@ -9219,7 +9234,7 @@ function createScanner(languageVersion, skipTrivia2, languageVariant = 0 /* Stan
             return pos += 2, token = 43 /* AsteriskAsteriskToken */;
           }
           pos++;
-          if (inJSDocType && !asteriskSeen && tokenFlags & 1 /* PrecedingLineBreak */) {
+          if (skipJsDocLeadingAsterisks && !asteriskSeen && tokenFlags & 1 /* PrecedingLineBreak */) {
             asteriskSeen = true;
             continue;
           }
@@ -9997,8 +10012,8 @@ function createScanner(languageVersion, skipTrivia2, languageVariant = 0 /* Stan
     tokenValue = void 0;
     tokenFlags = 0 /* None */;
   }
-  function setInJSDocType(inType) {
-    inJSDocType += inType ? 1 : -1;
+  function setSkipJsDocLeadingAsterisks(skip) {
+    skipJsDocLeadingAsterisks += skip ? 1 : -1;
   }
 }
 function codePointAt(s, i) {
@@ -11051,8 +11066,8 @@ function isExpressionKind(kind) {
     case 230 /* SpreadElement */:
     case 234 /* AsExpression */:
     case 232 /* OmittedExpression */:
-    case 354 /* CommaListExpression */:
-    case 353 /* PartiallyEmittedExpression */:
+    case 355 /* CommaListExpression */:
+    case 354 /* PartiallyEmittedExpression */:
     case 238 /* SatisfiesExpression */:
       return true;
     default:
@@ -11223,7 +11238,7 @@ function isDeclarationStatementKind(kind) {
   return kind === 262 /* FunctionDeclaration */ || kind === 282 /* MissingDeclaration */ || kind === 263 /* ClassDeclaration */ || kind === 264 /* InterfaceDeclaration */ || kind === 265 /* TypeAliasDeclaration */ || kind === 266 /* EnumDeclaration */ || kind === 267 /* ModuleDeclaration */ || kind === 272 /* ImportDeclaration */ || kind === 271 /* ImportEqualsDeclaration */ || kind === 278 /* ExportDeclaration */ || kind === 277 /* ExportAssignment */ || kind === 270 /* NamespaceExportDeclaration */;
 }
 function isStatementKindButNotDeclarationKind(kind) {
-  return kind === 252 /* BreakStatement */ || kind === 251 /* ContinueStatement */ || kind === 259 /* DebuggerStatement */ || kind === 246 /* DoStatement */ || kind === 244 /* ExpressionStatement */ || kind === 242 /* EmptyStatement */ || kind === 249 /* ForInStatement */ || kind === 250 /* ForOfStatement */ || kind === 248 /* ForStatement */ || kind === 245 /* IfStatement */ || kind === 256 /* LabeledStatement */ || kind === 253 /* ReturnStatement */ || kind === 255 /* SwitchStatement */ || kind === 257 /* ThrowStatement */ || kind === 258 /* TryStatement */ || kind === 243 /* VariableStatement */ || kind === 247 /* WhileStatement */ || kind === 254 /* WithStatement */ || kind === 352 /* NotEmittedStatement */;
+  return kind === 252 /* BreakStatement */ || kind === 251 /* ContinueStatement */ || kind === 259 /* DebuggerStatement */ || kind === 246 /* DoStatement */ || kind === 244 /* ExpressionStatement */ || kind === 242 /* EmptyStatement */ || kind === 249 /* ForInStatement */ || kind === 250 /* ForOfStatement */ || kind === 248 /* ForStatement */ || kind === 245 /* IfStatement */ || kind === 256 /* LabeledStatement */ || kind === 253 /* ReturnStatement */ || kind === 255 /* SwitchStatement */ || kind === 257 /* ThrowStatement */ || kind === 258 /* TryStatement */ || kind === 243 /* VariableStatement */ || kind === 247 /* WhileStatement */ || kind === 254 /* WithStatement */ || kind === 353 /* NotEmittedStatement */;
 }
 function isDeclaration(node) {
   if (node.kind === 168 /* TypeParameter */) {
@@ -11284,10 +11299,10 @@ function isCaseOrDefaultClause(node) {
   return kind === 296 /* CaseClause */ || kind === 297 /* DefaultClause */;
 }
 function isJSDocNode(node) {
-  return node.kind >= 309 /* FirstJSDocNode */ && node.kind <= 350 /* LastJSDocNode */;
+  return node.kind >= 309 /* FirstJSDocNode */ && node.kind <= 351 /* LastJSDocNode */;
 }
 function isJSDocTag(node) {
-  return node.kind >= 327 /* FirstJSDocTagNode */ && node.kind <= 350 /* LastJSDocTagNode */;
+  return node.kind >= 327 /* FirstJSDocTagNode */ && node.kind <= 351 /* LastJSDocTagNode */;
 }
 function isSetAccessor(node) {
   return node.kind === 178 /* SetAccessor */;
@@ -11728,7 +11743,7 @@ function getTokenPosOfNode(node, sourceFile, includeJsDoc) {
   if (includeJsDoc && hasJSDocNodes(node)) {
     return getTokenPosOfNode(node.jsDoc[0], sourceFile);
   }
-  if (node.kind === 351 /* SyntaxList */ && node._children.length > 0) {
+  if (node.kind === 352 /* SyntaxList */ && node._children.length > 0) {
     return getTokenPosOfNode(node._children[0], sourceFile, includeJsDoc);
   }
   return skipTrivia(
@@ -13682,6 +13697,7 @@ function tryGetModuleSpecifierFromDeclaration(node) {
       ))) == null ? void 0 : _a.arguments[0];
     case 272 /* ImportDeclaration */:
     case 278 /* ExportDeclaration */:
+    case 351 /* JSDocImportTag */:
       return tryCast(node.moduleSpecifier, isStringLiteralLike);
     case 271 /* ImportEqualsDeclaration */:
       return tryCast((_b = tryCast(node.moduleReference, isExternalModuleReference)) == null ? void 0 : _b.expression, isStringLiteralLike);
@@ -13703,6 +13719,7 @@ function getExternalModuleName(node) {
   switch (node.kind) {
     case 272 /* ImportDeclaration */:
     case 278 /* ExportDeclaration */:
+    case 351 /* JSDocImportTag */:
       return node.moduleSpecifier;
     case 271 /* ImportEqualsDeclaration */:
       return node.moduleReference.kind === 283 /* ExternalModuleReference */ ? node.moduleReference.expression : void 0;
@@ -13729,7 +13746,7 @@ function getNamespaceDeclarationNode(node) {
   }
 }
 function isDefaultImport(node) {
-  return node.kind === 272 /* ImportDeclaration */ && !!node.importClause && !!node.importClause.name;
+  return (node.kind === 272 /* ImportDeclaration */ || node.kind === 351 /* JSDocImportTag */) && !!node.importClause && !!node.importClause.name;
 }
 function hasQuestionToken(node) {
   if (node) {
@@ -14502,7 +14519,7 @@ function getOperator(expression) {
 }
 function getOperatorPrecedence(nodeKind, operatorKind, hasArguments) {
   switch (nodeKind) {
-    case 354 /* CommaListExpression */:
+    case 355 /* CommaListExpression */:
       return 0 /* Comma */;
     case 230 /* SpreadElement */:
       return 1 /* Spread */;
@@ -16051,7 +16068,7 @@ function getLeftmostExpression(node, stopAtCallExpressions) {
       case 212 /* ElementAccessExpression */:
       case 211 /* PropertyAccessExpression */:
       case 235 /* NonNullExpression */:
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
       case 238 /* SatisfiesExpression */:
         node = node.expression;
         continue;
@@ -17438,7 +17455,7 @@ function getContainingNodeArray(node) {
       return parent.types;
     case 189 /* TupleType */:
     case 209 /* ArrayLiteralExpression */:
-    case 354 /* CommaListExpression */:
+    case 355 /* CommaListExpression */:
     case 275 /* NamedImports */:
     case 279 /* NamedExports */:
       return parent.elements;
@@ -18637,6 +18654,8 @@ function createNodeFactory(flags, baseFactory2) {
     updateJSDocImplementsTag,
     createJSDocSeeTag,
     updateJSDocSeeTag,
+    createJSDocImportTag,
+    updateJSDocImportTag,
     createJSDocNameReference,
     updateJSDocNameReference,
     createJSDocMemberName,
@@ -21409,6 +21428,17 @@ function createNodeFactory(flags, baseFactory2) {
   function updateJSDocEnumTag(node, tagName = getDefaultTagName(node), typeExpression, comment) {
     return node.tagName !== tagName || node.typeExpression !== typeExpression || node.comment !== comment ? update(createJSDocEnumTag(tagName, typeExpression, comment), node) : node;
   }
+  function createJSDocImportTag(tagName, importClause, moduleSpecifier, attributes, comment) {
+    const node = createBaseJSDocTag(351 /* JSDocImportTag */, tagName ?? createIdentifier("import"), comment);
+    node.importClause = importClause;
+    node.moduleSpecifier = moduleSpecifier;
+    node.attributes = attributes;
+    node.comment = comment;
+    return node;
+  }
+  function updateJSDocImportTag(node, tagName, importClause, moduleSpecifier, attributes, comment) {
+    return node.tagName !== tagName || node.comment !== comment || node.importClause !== importClause || node.moduleSpecifier !== moduleSpecifier || node.attributes !== attributes ? update(createJSDocImportTag(tagName, importClause, moduleSpecifier, attributes, comment), node) : node;
+  }
   function createJSDocText(text) {
     const node = createBaseNode(321 /* JSDocText */);
     node.text = text;
@@ -21806,18 +21836,18 @@ function createNodeFactory(flags, baseFactory2) {
     return node;
   }
   function createSyntaxList(children) {
-    const node = createBaseNode(351 /* SyntaxList */);
+    const node = createBaseNode(352 /* SyntaxList */);
     node._children = children;
     return node;
   }
   function createNotEmittedStatement(original) {
-    const node = createBaseNode(352 /* NotEmittedStatement */);
+    const node = createBaseNode(353 /* NotEmittedStatement */);
     node.original = original;
     setTextRange(node, original);
     return node;
   }
   function createPartiallyEmittedExpression(expression, original) {
-    const node = createBaseNode(353 /* PartiallyEmittedExpression */);
+    const node = createBaseNode(354 /* PartiallyEmittedExpression */);
     node.expression = expression;
     node.original = original;
     node.transformFlags |= propagateChildFlags(node.expression) | 1 /* ContainsTypeScript */;
@@ -21839,7 +21869,7 @@ function createNodeFactory(flags, baseFactory2) {
     return node;
   }
   function createCommaListExpression(elements) {
-    const node = createBaseNode(354 /* CommaListExpression */);
+    const node = createBaseNode(355 /* CommaListExpression */);
     node.elements = createNodeArray(sameFlatMap(elements, flattenCommaElements));
     node.transformFlags |= propagateChildrenFlags(node.elements);
     return node;
@@ -21848,7 +21878,7 @@ function createNodeFactory(flags, baseFactory2) {
     return node.elements !== elements ? update(createCommaListExpression(elements), node) : node;
   }
   function createSyntheticReferenceExpression(expression, thisArg) {
-    const node = createBaseNode(355 /* SyntheticReferenceExpression */);
+    const node = createBaseNode(356 /* SyntheticReferenceExpression */);
     node.expression = expression;
     node.thisArg = thisArg;
     node.transformFlags |= propagateChildFlags(node.expression) | propagateChildFlags(node.thisArg);
@@ -22094,7 +22124,7 @@ function createNodeFactory(flags, baseFactory2) {
         return updateSatisfiesExpression(outerExpression, expression, outerExpression.type);
       case 235 /* NonNullExpression */:
         return updateNonNullExpression(outerExpression, expression);
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
         return updatePartiallyEmittedExpression(outerExpression, expression);
     }
   }
@@ -22504,6 +22534,8 @@ function getDefaultTagNameForKind(kind) {
       return "augments";
     case 329 /* JSDocImplementsTag */:
       return "implements";
+    case 351 /* JSDocImportTag */:
+      return "import";
     default:
       return Debug.fail(`Unsupported kind: ${Debug.formatSyntaxKind(kind)}`);
   }
@@ -22644,7 +22676,7 @@ function getTransformFlagsSubtreeExclusions(kind) {
     case 216 /* TypeAssertionExpression */:
     case 238 /* SatisfiesExpression */:
     case 234 /* AsExpression */:
-    case 353 /* PartiallyEmittedExpression */:
+    case 354 /* PartiallyEmittedExpression */:
     case 217 /* ParenthesizedExpression */:
     case 108 /* SuperKeyword */:
       return -2147483648 /* OuterExpressionExcludes */;
@@ -24282,10 +24314,10 @@ function isMetaProperty(node) {
   return node.kind === 236 /* MetaProperty */;
 }
 function isPartiallyEmittedExpression(node) {
-  return node.kind === 353 /* PartiallyEmittedExpression */;
+  return node.kind === 354 /* PartiallyEmittedExpression */;
 }
 function isCommaListExpression(node) {
-  return node.kind === 354 /* CommaListExpression */;
+  return node.kind === 355 /* CommaListExpression */;
 }
 function isTemplateSpan(node) {
   return node.kind === 239 /* TemplateSpan */;
@@ -24408,10 +24440,10 @@ function isExportSpecifier(node) {
   return node.kind === 281 /* ExportSpecifier */;
 }
 function isNotEmittedStatement(node) {
-  return node.kind === 352 /* NotEmittedStatement */;
+  return node.kind === 353 /* NotEmittedStatement */;
 }
 function isSyntheticReference(node) {
-  return node.kind === 355 /* SyntheticReferenceExpression */;
+  return node.kind === 356 /* SyntheticReferenceExpression */;
 }
 function isExternalModuleReference(node) {
   return node.kind === 283 /* ExternalModuleReference */;
@@ -24578,6 +24610,9 @@ function isJSDocImplementsTag(node) {
 function isJSDocSatisfiesTag(node) {
   return node.kind === 350 /* JSDocSatisfiesTag */;
 }
+function isJSDocImportTag(node) {
+  return node.kind === 351 /* JSDocImportTag */;
+}
 
 // src/compiler/factory/utilities.ts
 function createEmptyExports(factory2) {
@@ -24960,7 +24995,7 @@ function isOuterExpression(node, kinds = 15 /* All */) {
       return (kinds & 2 /* TypeAssertions */) !== 0;
     case 235 /* NonNullExpression */:
       return (kinds & 4 /* NonNullAssertions */) !== 0;
-    case 353 /* PartiallyEmittedExpression */:
+    case 354 /* PartiallyEmittedExpression */:
       return (kinds & 8 /* PartiallyEmittedExpressions */) !== 0;
   }
   return false;
@@ -26036,7 +26071,7 @@ var forEachChildTable = {
   [282 /* MissingDeclaration */]: function forEachChildInMissingDeclaration(node, cbNode, cbNodes) {
     return visitNodes(cbNode, cbNodes, node.modifiers);
   },
-  [354 /* CommaListExpression */]: function forEachChildInCommaListExpression(node, cbNode, cbNodes) {
+  [355 /* CommaListExpression */]: function forEachChildInCommaListExpression(node, cbNode, cbNodes) {
     return visitNodes(cbNode, cbNodes, node.elements);
   },
   [284 /* JsxElement */]: function forEachChildInJsxElement(node, cbNode, cbNodes) {
@@ -26131,7 +26166,8 @@ var forEachChildTable = {
   [336 /* JSDocReadonlyTag */]: forEachChildInJSDocTag,
   [331 /* JSDocDeprecatedTag */]: forEachChildInJSDocTag,
   [337 /* JSDocOverrideTag */]: forEachChildInJSDocTag,
-  [353 /* PartiallyEmittedExpression */]: forEachChildInPartiallyEmittedExpression
+  [351 /* JSDocImportTag */]: forEachChildInJSDocImportTag,
+  [354 /* PartiallyEmittedExpression */]: forEachChildInPartiallyEmittedExpression
 };
 function forEachChildInCallOrConstructSignature(node, cbNode, cbNodes) {
   return visitNodes(cbNode, cbNodes, node.typeParameters) || visitNodes(cbNode, cbNodes, node.parameters) || visitNode2(cbNode, node.type);
@@ -26182,6 +26218,9 @@ function forEachChildInJSDocLinkCodeOrPlain(node, cbNode, _cbNodes) {
 function forEachChildInJSDocTag(node, cbNode, cbNodes) {
   return visitNode2(cbNode, node.tagName) || (typeof node.comment === "string" ? void 0 : visitNodes(cbNode, cbNodes, node.comment));
 }
+function forEachChildInJSDocImportTag(node, cbNode, cbNodes) {
+  return visitNode2(cbNode, node.tagName) || visitNode2(cbNode, node.importClause) || visitNode2(cbNode, node.moduleSpecifier) || visitNode2(cbNode, node.attributes) || (typeof node.comment === "string" ? void 0 : visitNodes(cbNode, cbNodes, node.comment));
+}
 function forEachChildInPartiallyEmittedExpression(node, cbNode, _cbNodes) {
   return visitNode2(cbNode, node.expression);
 }
@@ -28174,7 +28213,7 @@ var Parser;
     );
   }
   function parseJSDocType() {
-    scanner.setInJSDocType(true);
+    scanner.setSkipJsDocLeadingAsterisks(true);
     const pos = getNodePos();
     if (parseOptional(144 /* ModuleKeyword */)) {
       const moduleTag = factory2.createJSDocNamepathType(
@@ -28193,12 +28232,12 @@ var Parser;
               nextTokenJSDoc();
           }
         }
-      scanner.setInJSDocType(false);
+      scanner.setSkipJsDocLeadingAsterisks(false);
       return finishNode(moduleTag, pos);
     }
     const hasDotDotDot = parseOptional(26 /* DotDotDotToken */);
     let type = parseTypeOrTypePredicate();
-    scanner.setInJSDocType(false);
+    scanner.setSkipJsDocLeadingAsterisks(false);
     if (hasDotDotDot) {
       type = finishNode(factory2.createJSDocVariadicType(type), pos);
     }
@@ -31761,22 +31800,28 @@ var Parser;
     if (identifier && !tokenAfterImportedIdentifierDefinitelyProducesImportDeclaration()) {
       return parseImportEqualsDeclaration(pos, hasJSDoc, modifiers, identifier, isTypeOnly);
     }
+    const importClause = tryParseImportClause(identifier, afterImportPos, isTypeOnly);
+    const moduleSpecifier = parseModuleSpecifier();
+    const attributes = tryParseImportAttributes();
+    parseSemicolon();
+    const node = factory2.createImportDeclaration(modifiers, importClause, moduleSpecifier, attributes);
+    return withJSDoc(finishNode(node, pos), hasJSDoc);
+  }
+  function tryParseImportClause(identifier, pos, isTypeOnly, skipJsDocLeadingAsterisks = false) {
     let importClause;
     if (identifier || // import id
     token() === 42 /* AsteriskToken */ || // import *
     token() === 19 /* OpenBraceToken */) {
-      importClause = parseImportClause(identifier, afterImportPos, isTypeOnly);
+      importClause = parseImportClause(identifier, pos, isTypeOnly, skipJsDocLeadingAsterisks);
       parseExpected(161 /* FromKeyword */);
     }
-    const moduleSpecifier = parseModuleSpecifier();
+    return importClause;
+  }
+  function tryParseImportAttributes() {
     const currentToken2 = token();
-    let attributes;
     if ((currentToken2 === 118 /* WithKeyword */ || currentToken2 === 132 /* AssertKeyword */) && !scanner.hasPrecedingLineBreak()) {
-      attributes = parseImportAttributes(currentToken2);
+      return parseImportAttributes(currentToken2);
     }
-    parseSemicolon();
-    const node = factory2.createImportDeclaration(modifiers, importClause, moduleSpecifier, attributes);
-    return withJSDoc(finishNode(node, pos), hasJSDoc);
   }
   function parseImportAttribute() {
     const pos = getNodePos();
@@ -31843,10 +31888,14 @@ var Parser;
     const finished = withJSDoc(finishNode(node, pos), hasJSDoc);
     return finished;
   }
-  function parseImportClause(identifier, pos, isTypeOnly) {
+  function parseImportClause(identifier, pos, isTypeOnly, skipJsDocLeadingAsterisks) {
     let namedBindings;
     if (!identifier || parseOptional(28 /* CommaToken */)) {
+      if (skipJsDocLeadingAsterisks)
+        scanner.setSkipJsDocLeadingAsterisks(true);
       namedBindings = token() === 42 /* AsteriskToken */ ? parseNamespaceImport() : parseNamedImportsOrExports(275 /* NamedImports */);
+      if (skipJsDocLeadingAsterisks)
+        scanner.setSkipJsDocLeadingAsterisks(false);
     }
     return finishNode(factory2.createImportClause(isTypeOnly, identifier, namedBindings), pos);
   }
@@ -32417,6 +32466,9 @@ var Parser;
           case "throws":
             tag = parseThrowsTag(start2, tagName, margin, indentText);
             break;
+          case "import":
+            tag = parseImportTag(start2, tagName, margin, indentText);
+            break;
           default:
             tag = parseUnknownTag(start2, tagName, margin, indentText);
             break;
@@ -32736,13 +32788,32 @@ var Parser;
         const comments2 = margin !== void 0 && indentText !== void 0 ? parseTrailingTagComments(start2, getNodePos(), margin, indentText) : void 0;
         return finishNode(factory2.createJSDocSatisfiesTag(tagName, typeExpression, comments2), start2);
       }
+      function parseImportTag(start2, tagName, margin, indentText) {
+        const afterImportTagPos = scanner.getTokenFullStart();
+        let identifier;
+        if (isIdentifier2()) {
+          identifier = parseIdentifier();
+        }
+        const importClause = tryParseImportClause(
+          identifier,
+          afterImportTagPos,
+          /*isTypeOnly*/
+          true,
+          /*skipJsDocLeadingAsterisks*/
+          true
+        );
+        const moduleSpecifier = parseModuleSpecifier();
+        const attributes = tryParseImportAttributes();
+        const comments2 = margin !== void 0 && indentText !== void 0 ? parseTrailingTagComments(start2, getNodePos(), margin, indentText) : void 0;
+        return finishNode(factory2.createJSDocImportTag(tagName, importClause, moduleSpecifier, attributes, comments2), start2);
+      }
       function parseExpressionWithTypeArgumentsForAugments() {
         const usedBrace = parseOptional(19 /* OpenBraceToken */);
         const pos = getNodePos();
         const expression = parsePropertyAccessEntityNameExpression();
-        scanner.setInJSDocType(true);
+        scanner.setSkipJsDocLeadingAsterisks(true);
         const typeArguments = tryParseTypeArguments();
-        scanner.setInJSDocType(false);
+        scanner.setSkipJsDocLeadingAsterisks(false);
         const node = factory2.createExpressionWithTypeArguments(expression, typeArguments);
         const res = finishNode(node, pos);
         if (usedBrace) {
@@ -39421,6 +39492,7 @@ function createBinder() {
   var lastContainer;
   var delayedTypeAliases;
   var seenThisKeyword;
+  var jsDocImports;
   var currentFlow;
   var currentBreakTarget;
   var currentContinueTarget;
@@ -39468,6 +39540,7 @@ function createBinder() {
       file.symbolCount = symbolCount;
       file.classifiableNames = classifiableNames;
       delayedBindJSDocTypedefTag();
+      bindJSDocImports();
     }
     file = void 0;
     options = void 0;
@@ -39478,6 +39551,7 @@ function createBinder() {
     blockScopeContainer = void 0;
     lastContainer = void 0;
     delayedTypeAliases = void 0;
+    jsDocImports = void 0;
     seenThisKeyword = false;
     currentFlow = void 0;
     currentBreakTarget = void 0;
@@ -39912,6 +39986,9 @@ function createBinder() {
       case 340 /* JSDocEnumTag */:
         bindJSDocTypeAlias(node);
         break;
+      case 351 /* JSDocImportTag */:
+        bindJSDocImportTag(node);
+        break;
       case 307 /* SourceFile */: {
         bindEachFunctionsFirst(node.statements);
         bind(node.endOfFileToken);
@@ -40644,6 +40721,12 @@ function createBinder() {
       addDeclarationToSymbol(host.symbol, host, 32 /* Class */);
     }
   }
+  function bindJSDocImportTag(node) {
+    bind(node.tagName);
+    if (typeof node.comment !== "string") {
+      bindEach(node.comment);
+    }
+  }
   function bindOptionalExpression(node, trueTarget, falseTarget) {
     doWithConditionalBranches(bind, node, trueTarget, falseTarget);
     if (!isOptionalChain(node) || isOutermostOptionalChain(node)) {
@@ -40960,6 +41043,31 @@ function createBinder() {
     parent = saveParent;
     currentFlow = saveCurrentFlow;
   }
+  function bindJSDocImports() {
+    if (jsDocImports === void 0) {
+      return;
+    }
+    const saveContainer = container;
+    const saveLastContainer = lastContainer;
+    const saveBlockScopeContainer = blockScopeContainer;
+    const saveParent = parent;
+    const saveCurrentFlow = currentFlow;
+    for (const jsDocImportTag of jsDocImports) {
+      const host = getJSDocHost(jsDocImportTag);
+      const enclosingContainer = host ? getEnclosingContainer(host) : void 0;
+      const enclosingBlockScopeContainer = host ? getEnclosingBlockScopeContainer(host) : void 0;
+      container = enclosingContainer || file;
+      blockScopeContainer = enclosingBlockScopeContainer || file;
+      currentFlow = initFlowNode({ flags: 2 /* Start */ });
+      parent = jsDocImportTag;
+      bind(jsDocImportTag.importClause);
+    }
+    container = saveContainer;
+    lastContainer = saveLastContainer;
+    blockScopeContainer = saveBlockScopeContainer;
+    parent = saveParent;
+    currentFlow = saveCurrentFlow;
+  }
   function checkContextualIdentifier(node) {
     if (!file.parseDiagnostics.length && !(node.flags & 33554432 /* Ambient */) && !(node.flags & 16777216 /* JSDoc */) && !isIdentifierName(node)) {
       const originalKeywordKind = identifierToKeywordKind(node);
@@ -41384,6 +41492,8 @@ function createBinder() {
         return (delayedTypeAliases || (delayedTypeAliases = [])).push(node);
       case 339 /* JSDocOverloadTag */:
         return bind(node.typeExpression);
+      case 351 /* JSDocImportTag */:
+        return (jsDocImports || (jsDocImports = [])).push(node);
     }
   }
   function bindPropertyWorker(node) {
@@ -44668,11 +44778,11 @@ function createTypeChecker(host) {
       } else if (declaration.kind === 260 /* VariableDeclaration */) {
         return !isImmediatelyUsedInInitializerOfBlockScopedVariable(declaration, usage);
       } else if (isClassLike(declaration)) {
-        const container = findAncestor(usage, (n) => n === declaration ? "quit" : isComputedPropertyName(n) ? n.parent.parent === declaration : isDecorator(n) && (n.parent === declaration || isMethodDeclaration(n.parent) && n.parent.parent === declaration || isGetOrSetAccessorDeclaration(n.parent) && n.parent.parent === declaration || isPropertyDeclaration(n.parent) && n.parent.parent === declaration || isParameter(n.parent) && n.parent.parent.parent === declaration));
+        const container = findAncestor(usage, (n) => n === declaration ? "quit" : isComputedPropertyName(n) ? n.parent.parent === declaration : !legacyDecorators && isDecorator(n) && (n.parent === declaration || isMethodDeclaration(n.parent) && n.parent.parent === declaration || isGetOrSetAccessorDeclaration(n.parent) && n.parent.parent === declaration || isPropertyDeclaration(n.parent) && n.parent.parent === declaration || isParameter(n.parent) && n.parent.parent.parent === declaration));
         if (!container) {
           return true;
         }
-        if (isDecorator(container)) {
+        if (!legacyDecorators && isDecorator(container)) {
           return !!findAncestor(usage, (n) => n === container ? "quit" : isFunctionLike(n) && !getImmediatelyInvokedFunctionExpression(n));
         }
         return false;
@@ -45024,6 +45134,7 @@ function createTypeChecker(host) {
           case 346 /* JSDocTypedefTag */:
           case 338 /* JSDocCallbackTag */:
           case 340 /* JSDocEnumTag */:
+          case 351 /* JSDocImportTag */:
             const root = getJSDocRoot(location);
             if (root) {
               location = root.parent;
@@ -46516,7 +46627,7 @@ function createTypeChecker(host) {
       return ambientModule;
     }
     const currentSourceFile = getSourceFileOfNode(location);
-    const contextSpecifier = isStringLiteralLike(location) ? location : ((_a = isModuleDeclaration(location) ? location : location.parent && isModuleDeclaration(location.parent) && location.parent.name === location ? location.parent : void 0) == null ? void 0 : _a.name) || ((_b = isLiteralImportTypeNode(location) ? location : void 0) == null ? void 0 : _b.argument.literal) || (isVariableDeclaration(location) && location.initializer && isRequireCall(
+    const contextSpecifier = isStringLiteralLike(location) ? location : ((_a = isModuleDeclaration(location) ? location : location.parent && isModuleDeclaration(location.parent) && location.parent.name === location ? location.parent : void 0) == null ? void 0 : _a.name) || ((_b = isLiteralImportTypeNode(location) ? location : void 0) == null ? void 0 : _b.argument.literal) || (isInJSFile(location) && isJSDocImportTag(location) ? location.moduleSpecifier : void 0) || (isVariableDeclaration(location) && location.initializer && isRequireCall(
       location.initializer,
       /*requireStringLiteralLikeArgument*/
       true
@@ -50892,19 +51003,20 @@ function createTypeChecker(host) {
           case 273 /* ImportClause */: {
             const generatedSpecifier = getSpecifierForModuleSymbol(target.parent || target, context);
             const specifier2 = bundled ? factory.createStringLiteral(generatedSpecifier) : node.parent.moduleSpecifier;
+            const attributes = isImportDeclaration(node.parent) ? node.parent.attributes : void 0;
+            const isTypeOnly = isJSDocImportTag(node.parent);
             addResult(
               factory.createImportDeclaration(
                 /*modifiers*/
                 void 0,
                 factory.createImportClause(
-                  /*isTypeOnly*/
-                  false,
+                  isTypeOnly,
                   factory.createIdentifier(localName),
                   /*namedBindings*/
                   void 0
                 ),
                 specifier2,
-                node.parent.attributes
+                attributes
               ),
               0 /* None */
             );
@@ -50913,13 +51025,13 @@ function createTypeChecker(host) {
           case 274 /* NamespaceImport */: {
             const generatedSpecifier = getSpecifierForModuleSymbol(target.parent || target, context);
             const specifier2 = bundled ? factory.createStringLiteral(generatedSpecifier) : node.parent.parent.moduleSpecifier;
+            const isTypeOnly = isJSDocImportTag(node.parent.parent);
             addResult(
               factory.createImportDeclaration(
                 /*modifiers*/
                 void 0,
                 factory.createImportClause(
-                  /*isTypeOnly*/
-                  false,
+                  isTypeOnly,
                   /*name*/
                   void 0,
                   factory.createNamespaceImport(factory.createIdentifier(localName))
@@ -50947,13 +51059,13 @@ function createTypeChecker(host) {
           case 276 /* ImportSpecifier */: {
             const generatedSpecifier = getSpecifierForModuleSymbol(target.parent || target, context);
             const specifier2 = bundled ? factory.createStringLiteral(generatedSpecifier) : node.parent.parent.parent.moduleSpecifier;
+            const isTypeOnly = isJSDocImportTag(node.parent.parent.parent);
             addResult(
               factory.createImportDeclaration(
                 /*modifiers*/
                 void 0,
                 factory.createImportClause(
-                  /*isTypeOnly*/
-                  false,
+                  isTypeOnly,
                   /*name*/
                   void 0,
                   factory.createNamedImports([
@@ -53633,7 +53745,7 @@ function createTypeChecker(host) {
         if (!lateSymbol)
           lateSymbols.set(memberName, lateSymbol = createSymbol(0 /* None */, memberName, 4096 /* Late */));
         const earlySymbol = earlySymbols && earlySymbols.get(memberName);
-        if (!(parent.flags & 32 /* Class */) && (lateSymbol.flags & getExcludedSymbolFlags(symbolFlags) || earlySymbol)) {
+        if (!(parent.flags & 32 /* Class */) && lateSymbol.flags & getExcludedSymbolFlags(symbolFlags)) {
           const declarations = earlySymbol ? concatenate(earlySymbol.declarations, lateSymbol.declarations) : lateSymbol.declarations;
           const name = !(type.flags & 8192 /* UniqueESSymbol */) && unescapeLeadingUnderscores(memberName) || declarationNameToString(declName);
           forEach(declarations, (declaration) => error(getNameOfDeclaration(declaration) || declaration, Diagnostics.Property_0_was_also_declared_here, name));
@@ -65159,13 +65271,20 @@ function createTypeChecker(host) {
         return getFlowCacheKey(node.expression, declaredType, initialType, flowContainer);
       case 166 /* QualifiedName */:
         const left = getFlowCacheKey(node.left, declaredType, initialType, flowContainer);
-        return left && left + "." + node.right.escapedText;
+        return left && `${left}.${node.right.escapedText}`;
       case 211 /* PropertyAccessExpression */:
       case 212 /* ElementAccessExpression */:
         const propName = getAccessedPropertyName(node);
         if (propName !== void 0) {
           const key = getFlowCacheKey(node.expression, declaredType, initialType, flowContainer);
-          return key && key + "." + propName;
+          return key && `${key}.${propName}`;
+        }
+        if (isElementAccessExpression(node) && isIdentifier(node.argumentExpression)) {
+          const symbol = getResolvedSymbol(node.argumentExpression);
+          if (isConstantVariable(symbol) || isParameterOrMutableLocalVariable(symbol) && !isSymbolAssigned(symbol)) {
+            const key = getFlowCacheKey(node.expression, declaredType, initialType, flowContainer);
+            return key && `${key}.@${getSymbolId(symbol)}`;
+          }
         }
         break;
       case 206 /* ObjectBindingPattern */:
@@ -65202,8 +65321,19 @@ function createTypeChecker(host) {
       case 211 /* PropertyAccessExpression */:
       case 212 /* ElementAccessExpression */:
         const sourcePropertyName = getAccessedPropertyName(source);
-        const targetPropertyName = isAccessExpression(target) ? getAccessedPropertyName(target) : void 0;
-        return sourcePropertyName !== void 0 && targetPropertyName !== void 0 && targetPropertyName === sourcePropertyName && isMatchingReference(source.expression, target.expression);
+        if (sourcePropertyName !== void 0) {
+          const targetPropertyName = isAccessExpression(target) ? getAccessedPropertyName(target) : void 0;
+          if (targetPropertyName !== void 0) {
+            return targetPropertyName === sourcePropertyName && isMatchingReference(source.expression, target.expression);
+          }
+        }
+        if (isElementAccessExpression(source) && isElementAccessExpression(target) && isIdentifier(source.argumentExpression) && isIdentifier(target.argumentExpression)) {
+          const symbol = getResolvedSymbol(source.argumentExpression);
+          if (symbol === getResolvedSymbol(target.argumentExpression) && (isConstantVariable(symbol) || isParameterOrMutableLocalVariable(symbol) && !isSymbolAssigned(symbol))) {
+            return isMatchingReference(source.expression, target.expression);
+          }
+        }
+        break;
       case 166 /* QualifiedName */:
         return isAccessExpression(target) && source.right.escapedText === getAccessedPropertyName(target) && isMatchingReference(source.left, target.expression);
       case 226 /* BinaryExpression */:
@@ -67747,11 +67877,6 @@ function createTypeChecker(host) {
         case 266 /* EnumDeclaration */:
           error(node, Diagnostics.this_cannot_be_referenced_in_current_location);
           break;
-        case 176 /* Constructor */:
-          if (isInConstructorArgumentInitializer(node, container)) {
-            error(node, Diagnostics.this_cannot_be_referenced_in_constructor_arguments);
-          }
-          break;
       }
     }
     if (!isNodeInTypeQuery && capturedByArrowFunction && languageVersion < 2 /* ES2015 */) {
@@ -77839,6 +77964,9 @@ function createTypeChecker(host) {
       error(node.tagName, Diagnostics.An_arrow_function_cannot_have_a_this_parameter);
     }
   }
+  function checkJSDocImportTag(node) {
+    checkImportAttributes(node);
+  }
   function checkJSDocImplementsTag(node) {
     const classLike = getEffectiveJSDocHost(node);
     if (!classLike || !isClassDeclaration(classLike) && !isClassExpression(classLike)) {
@@ -81106,7 +81234,8 @@ function createTypeChecker(host) {
         const message = isImportAttributes2 ? moduleKind === 199 /* NodeNext */ ? Diagnostics.Import_attributes_are_not_allowed_on_statements_that_compile_to_CommonJS_require_calls : Diagnostics.Import_attributes_are_only_supported_when_the_module_option_is_set_to_esnext_nodenext_or_preserve : moduleKind === 199 /* NodeNext */ ? Diagnostics.Import_assertions_are_not_allowed_on_statements_that_compile_to_CommonJS_require_calls : Diagnostics.Import_assertions_are_only_supported_when_the_module_option_is_set_to_esnext_nodenext_or_preserve;
         return grammarErrorOnNode(node, message);
       }
-      if (isImportDeclaration(declaration) ? (_a = declaration.importClause) == null ? void 0 : _a.isTypeOnly : declaration.isTypeOnly) {
+      const isTypeOnly = isJSDocImportTag(declaration) || (isImportDeclaration(declaration) ? (_a = declaration.importClause) == null ? void 0 : _a.isTypeOnly : declaration.isTypeOnly);
+      if (isTypeOnly) {
         return grammarErrorOnNode(node, isImportAttributes2 ? Diagnostics.Import_attributes_cannot_be_used_with_type_only_imports_or_exports : Diagnostics.Import_assertions_cannot_be_used_with_type_only_imports_or_exports);
       }
       if (override) {
@@ -81557,6 +81686,8 @@ function createTypeChecker(host) {
         return checkJSDocSatisfiesTag(node);
       case 343 /* JSDocThisTag */:
         return checkJSDocThisTag(node);
+      case 351 /* JSDocImportTag */:
+        return checkJSDocImportTag(node);
       case 199 /* IndexedAccessType */:
         return checkIndexedAccessType(node);
       case 200 /* MappedType */:
@@ -82360,7 +82491,7 @@ function createTypeChecker(host) {
         return void 0;
       case 11 /* StringLiteral */:
       case 15 /* NoSubstitutionTemplateLiteral */:
-        if (isExternalModuleImportEqualsDeclaration(node.parent.parent) && getExternalModuleImportEqualsDeclarationExpression(node.parent.parent) === node || (node.parent.kind === 272 /* ImportDeclaration */ || node.parent.kind === 278 /* ExportDeclaration */) && node.parent.moduleSpecifier === node || (isInJSFile(node) && isRequireCall(
+        if (isExternalModuleImportEqualsDeclaration(node.parent.parent) && getExternalModuleImportEqualsDeclarationExpression(node.parent.parent) === node || (node.parent.kind === 272 /* ImportDeclaration */ || node.parent.kind === 278 /* ExportDeclaration */) && node.parent.moduleSpecifier === node || isInJSFile(node) && isJSDocImportTag(node.parent) && node.parent.moduleSpecifier === node || (isInJSFile(node) && isRequireCall(
           node.parent,
           /*requireStringLiteralLikeArgument*/
           false
@@ -86501,13 +86632,13 @@ var visitEachChildTable = {
     );
   },
   // Transformation nodes
-  [353 /* PartiallyEmittedExpression */]: function visitEachChildOfPartiallyEmittedExpression(node, visitor, context, _nodesVisitor, nodeVisitor, _tokenVisitor) {
+  [354 /* PartiallyEmittedExpression */]: function visitEachChildOfPartiallyEmittedExpression(node, visitor, context, _nodesVisitor, nodeVisitor, _tokenVisitor) {
     return context.factory.updatePartiallyEmittedExpression(
       node,
       Debug.checkDefined(nodeVisitor(node.expression, visitor, isExpression))
     );
   },
-  [354 /* CommaListExpression */]: function visitEachChildOfCommaListExpression(node, visitor, context, nodesVisitor, _nodeVisitor, _tokenVisitor) {
+  [355 /* CommaListExpression */]: function visitEachChildOfCommaListExpression(node, visitor, context, nodesVisitor, _nodeVisitor, _tokenVisitor) {
     return context.factory.updateCommaListExpression(
       node,
       nodesVisitor(node.elements, visitor, isExpression)
@@ -90164,7 +90295,7 @@ function transformClassFields(context) {
           /*discarded*/
           true
         );
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return visitCommaListExpression(
           node,
           /*discarded*/
@@ -93257,7 +93388,7 @@ function transformESDecorators(context) {
         return visitForStatement(node);
       case 244 /* ExpressionStatement */:
         return visitExpressionStatement(node);
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return visitCommaListExpression(
           node,
           /*discarded*/
@@ -93269,7 +93400,7 @@ function transformESDecorators(context) {
           /*discarded*/
           false
         );
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
         return visitPartiallyEmittedExpression(
           node,
           /*discarded*/
@@ -93355,7 +93486,7 @@ function transformESDecorators(context) {
           /*discarded*/
           true
         );
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return visitCommaListExpression(
           node,
           /*discarded*/
@@ -95946,7 +96077,7 @@ function transformES2018(context) {
         return visitObjectLiteralExpression(node);
       case 226 /* BinaryExpression */:
         return visitBinaryExpression(node, expressionResultIsUnused2);
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return visitCommaListExpression(node, expressionResultIsUnused2);
       case 299 /* CatchClause */:
         return visitCatchClause(node);
@@ -99169,7 +99300,7 @@ function transformES2015(context) {
         return visitParenthesizedExpression(node, expressionResultIsUnused2);
       case 226 /* BinaryExpression */:
         return visitBinaryExpression(node, expressionResultIsUnused2);
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return visitCommaListExpression(node, expressionResultIsUnused2);
       case 15 /* NoSubstitutionTemplateLiteral */:
       case 16 /* TemplateHead */:
@@ -102464,7 +102595,7 @@ function transformGenerators(context) {
     switch (node.kind) {
       case 226 /* BinaryExpression */:
         return visitBinaryExpression(node);
-      case 354 /* CommaListExpression */:
+      case 355 /* CommaListExpression */:
         return visitCommaListExpression(node);
       case 227 /* ConditionalExpression */:
         return visitConditionalExpression(node);
@@ -104854,7 +104985,7 @@ function transformModule(context) {
         return visitExpressionStatement(node);
       case 217 /* ParenthesizedExpression */:
         return visitParenthesizedExpression(node, valueIsDiscarded);
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
         return visitPartiallyEmittedExpression(node, valueIsDiscarded);
       case 213 /* CallExpression */:
         if (isImportCall(node) && currentSourceFile.impliedNodeFormat === void 0) {
@@ -107247,7 +107378,7 @@ function transformSystemModule(context) {
         return visitExpressionStatement(node);
       case 217 /* ParenthesizedExpression */:
         return visitParenthesizedExpression(node, valueIsDiscarded);
-      case 353 /* PartiallyEmittedExpression */:
+      case 354 /* PartiallyEmittedExpression */:
         return visitPartiallyEmittedExpression(node, valueIsDiscarded);
       case 226 /* BinaryExpression */:
         if (isDestructuringAssignment(node)) {
@@ -109260,6 +109391,8 @@ function transformDeclarations(context) {
     }
     if (isDeclaration(input) && isDeclarationAndNotVisible(input))
       return;
+    if (isJSDocImportTag(input))
+      return;
     if (isFunctionLike(input) && resolver.isImplementationOfOverload(input))
       return;
     let previousEnclosingDeclaration;
@@ -109907,7 +110040,7 @@ function noEmitNotification(hint, node, callback) {
 }
 function transformNodes(resolver, host, factory2, options, nodes, transformers, allowDtsFiles) {
   var _a, _b;
-  const enabledSyntaxKindFeatures = new Array(356 /* Count */);
+  const enabledSyntaxKindFeatures = new Array(357 /* Count */);
   let lexicalEnvironmentVariableDeclarations;
   let lexicalEnvironmentFunctionDeclarations;
   let lexicalEnvironmentStatements;
@@ -111475,7 +111608,9 @@ function createPrinter(printerOptions = {}, handlers = {}) {
           return emitJSDocTypedefTag(node);
         case 347 /* JSDocSeeTag */:
           return emitJSDocSeeTag(node);
-        case 352 /* NotEmittedStatement */:
+        case 351 /* JSDocImportTag */:
+          return emitJSDocImportTag(node);
+        case 353 /* NotEmittedStatement */:
           return;
       }
       if (isExpression(node)) {
@@ -111576,15 +111711,15 @@ function createPrinter(printerOptions = {}, handlers = {}) {
           return emitJsxSelfClosingElement(node);
         case 288 /* JsxFragment */:
           return emitJsxFragment(node);
-        case 351 /* SyntaxList */:
+        case 352 /* SyntaxList */:
           return Debug.fail("SyntaxList should not be printed");
-        case 352 /* NotEmittedStatement */:
+        case 353 /* NotEmittedStatement */:
           return;
-        case 353 /* PartiallyEmittedExpression */:
+        case 354 /* PartiallyEmittedExpression */:
           return emitPartiallyEmittedExpression(node);
-        case 354 /* CommaListExpression */:
+        case 355 /* CommaListExpression */:
           return emitCommaList(node);
-        case 355 /* SyntheticReferenceExpression */:
+        case 356 /* SyntheticReferenceExpression */:
           return Debug.fail("SyntheticReferenceExpression should not be printed");
       }
     }
@@ -113428,6 +113563,21 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     emit(tag.name);
     emitJSDocComment(tag.comment);
   }
+  function emitJSDocImportTag(tag) {
+    emitJSDocTagName(tag.tagName);
+    writeSpace();
+    if (tag.importClause) {
+      emit(tag.importClause);
+      writeSpace();
+      emitTokenWithComment(161 /* FromKeyword */, tag.importClause.end, writeKeyword, tag);
+      writeSpace();
+    }
+    emitExpression(tag.moduleSpecifier);
+    if (tag.attributes) {
+      emitWithLeadingSpace(tag.attributes);
+    }
+    emitJSDocComment(tag.comment);
+  }
   function emitJSDocNameReference(node) {
     writeSpace();
     writePunctuation("{");
@@ -114840,7 +114990,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
         emitLeadingComments(
           pos,
           /*isEmittedNode*/
-          node.kind !== 352 /* NotEmittedStatement */
+          node.kind !== 353 /* NotEmittedStatement */
         );
       }
       if (!skipLeadingComments || pos >= 0 && (emitFlags & 1024 /* NoLeadingComments */) !== 0) {
@@ -114864,7 +115014,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
       containerPos = savedContainerPos;
       containerEnd = savedContainerEnd;
       declarationListContainerEnd = savedDeclarationListContainerEnd;
-      if (!skipTrailingComments && node.kind !== 352 /* NotEmittedStatement */) {
+      if (!skipTrailingComments && node.kind !== 353 /* NotEmittedStatement */) {
         emitTrailingComments(end);
       }
     }
@@ -115116,7 +115266,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     const emitFlags = getEmitFlags(node);
     const sourceMapRange = getSourceMapRange(node);
     const source = sourceMapRange.source || sourceMapSource;
-    if (node.kind !== 352 /* NotEmittedStatement */ && (emitFlags & 32 /* NoLeadingSourceMap */) === 0 && sourceMapRange.pos >= 0) {
+    if (node.kind !== 353 /* NotEmittedStatement */ && (emitFlags & 32 /* NoLeadingSourceMap */) === 0 && sourceMapRange.pos >= 0) {
       emitSourcePos(sourceMapRange.source || sourceMapSource, skipSourceTrivia(source, sourceMapRange.pos));
     }
     if (emitFlags & 128 /* NoNestedSourceMaps */) {
@@ -115129,7 +115279,7 @@ function createPrinter(printerOptions = {}, handlers = {}) {
     if (emitFlags & 128 /* NoNestedSourceMaps */) {
       sourceMapsDisabled = false;
     }
-    if (node.kind !== 352 /* NotEmittedStatement */ && (emitFlags & 64 /* NoTrailingSourceMap */) === 0 && sourceMapRange.end >= 0) {
+    if (node.kind !== 353 /* NotEmittedStatement */ && (emitFlags & 64 /* NoTrailingSourceMap */) === 0 && sourceMapRange.end >= 0) {
       emitSourcePos(sourceMapRange.source || sourceMapSource, sourceMapRange.end);
     }
   }
@@ -118010,7 +118160,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
       );
     }
     if (file.flags & 4194304 /* PossiblyContainsDynamicImport */ || isJavaScriptFile) {
-      collectDynamicImportOrRequireCalls(file);
+      collectDynamicImportOrRequireOrJsDocImportCalls(file);
     }
     file.imports = imports || emptyArray;
     file.moduleAugmentations = moduleAugmentations || emptyArray;
@@ -118054,7 +118204,7 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
         }
       }
     }
-    function collectDynamicImportOrRequireCalls(file2) {
+    function collectDynamicImportOrRequireOrJsDocImportCalls(file2) {
       const r = /import|require/g;
       while (r.exec(file2.text) !== null) {
         const node = getNodeAtPosition(file2, r.lastIndex);
@@ -118083,6 +118233,16 @@ function createProgram(rootNamesOrOptions, _options, _host, _oldProgram, _config
             false
           );
           imports = append(imports, node.argument.literal);
+        } else if (isJavaScriptFile && isJSDocImportTag(node)) {
+          const moduleNameExpr = getExternalModuleName(node);
+          if (moduleNameExpr && isStringLiteral(moduleNameExpr) && moduleNameExpr.text) {
+            setParentRecursive(
+              node,
+              /*incremental*/
+              false
+            );
+            imports = append(imports, moduleNameExpr);
+          }
         }
       }
     }
@@ -121714,7 +121874,7 @@ function createResolutionCache(resolutionHost, rootDirForResolution, logChangesW
       newProgram == null ? void 0 : newProgram.getSourceFiles().forEach((newFile) => {
         var _a;
         const expected = isExternalOrCommonJsModule(newFile) ? ((_a = newFile.packageJsonLocations) == null ? void 0 : _a.length) ?? 0 : 0;
-        const existing = impliedFormatPackageJsons.get(newFile.path) ?? emptyArray;
+        const existing = impliedFormatPackageJsons.get(newFile.resolvedPath) ?? emptyArray;
         for (let i = existing.length; i < expected; i++) {
           createFileWatcherOfAffectingLocation(
             newFile.packageJsonLocations[i],
@@ -121728,9 +121888,9 @@ function createResolutionCache(resolutionHost, rootDirForResolution, logChangesW
           }
         }
         if (expected)
-          impliedFormatPackageJsons.set(newFile.path, newFile.packageJsonLocations);
+          impliedFormatPackageJsons.set(newFile.resolvedPath, newFile.packageJsonLocations);
         else
-          impliedFormatPackageJsons.delete(newFile.path);
+          impliedFormatPackageJsons.delete(newFile.resolvedPath);
       });
       impliedFormatPackageJsons.forEach((existing, path) => {
         if (!(newProgram == null ? void 0 : newProgram.getSourceFileByPath(path))) {