brighterscript 1.0.0-alpha.5 → 1.0.0-alpha.51

package/dist/DiagnosticMessages.d.ts

@@ -1,646 +1,1045 @@
 import type { Position } from 'vscode-languageserver';
 import { DiagnosticSeverity } from 'vscode-languageserver';
-import type { BsDiagnostic } from './interfaces';
-import type { TokenKind } from './lexer/TokenKind';
+import type { BsDiagnostic, TypeCompatibilityData } from './interfaces';
+import { TokenKind } from './lexer/TokenKind';
+import { SymbolTypeFlag } from './SymbolTypeFlag';
+import type { BscType } from './types/BscType';
+export declare const DiagnosticCodeRegex: RegExp;
 /**
  * An object that keeps track of all possible error messages.
  */
 export declare let DiagnosticMessages: {
     genericParserMessage: (message: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    callToUnknownFunction: (name: string, scopeName: string) => {
+    /**
+     *
+     * @param name for local vars, it's the var name. for namespaced parts, it's the specific part that's unknown (`alpha.beta.charlie` would result in "cannot find name 'charlie')
+     * @param fullName if a namespaced name, this is the full name `alpha.beta.charlie`, otherwise it's the same as `name`
+     * @param typeName if 'name' refers to a member, what is the the type it is a member of?
+     * @param typeDescriptor defaults to 'type' ... could also be 'namespace', etc.
+     */
+    cannotFindName: (name: string, fullName?: string, typeName?: string, typeDescriptor?: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         data: {
-            functionName: string;
+            name: string;
+            fullName: string;
+            typeName: string;
         };
         severity: 1;
+        code: string;
     };
     mismatchArgumentCount: (expectedCount: number | string, actualCount: number) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    duplicateFunctionImplementation: (functionName: string, scopeName: string) => {
+    duplicateFunctionImplementation: (functionName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     referencedFileDoesNotExist: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     xmlComponentMissingComponentDeclaration: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     xmlComponentMissingNameAttribute: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     xmlComponentMissingExtendsAttribute: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 2;
+        code: string;
     };
-    xmlGenericParseError: (message: string) => {
+    syntaxError: (message: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     unnecessaryScriptImportInChildFromParent: (parentComponentName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 2;
+        code: string;
     };
     overridesAncestorFunction: (callableName: string, currentScopeName: string, parentFilePath: string, parentScopeName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 4;
+        code: string;
     };
     localVarFunctionShadowsParentFunction: (scopeName: 'stdlib' | 'scope') => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 2;
+        code: string;
     };
-    scriptImportCaseMismatch: (correctFilePath: string) => {
+    scriptImportCaseMismatch: (correctFilePath: string, correctUri?: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
+        data: {
+            correctFilePath: string;
+        };
         severity: 2;
+        code: string;
     };
     fileNotReferencedByAnyOtherFile: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 2;
+        code: string;
     };
-    unknownDiagnosticCode: (theUnknownCode: number) => {
+    unknownDiagnosticCode: (theUnknownCode: number | string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 2;
+        code: string;
     };
     scriptSrcCannotBeEmpty: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedIdentifierAfterKeyword: (keywordText: string) => {
+    expectedIdentifier: (preceedingTokenText?: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     missingCallableKeyword: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedValidTypeToFollowAsKeyword: () => {
+    __unused12: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     bsFeatureNotSupportedInBrsFiles: (featureName: any) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    brsConfigJsonIsDeprecated: () => {
+    __ununsed12: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 2;
+        code: string;
     };
     bsConfigJsonHasSyntaxErrors: (message: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    namespacedClassCannotShareNamewithNonNamespacedClass: (nonNamespacedClassName: string) => {
+    itemIsDeprecated: (itemName?: string, deprecatedDescription?: string) => {
         message: string;
-        code: number;
-        severity: 1;
+        legacyCode: number;
+        severity: 4;
+        code: string;
     };
     cannotUseOverrideKeywordOnConstructorFunction: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    importStatementMustBeDeclaredAtTopOfFile: () => {
+    unexpectedStatementLocation: (statementKeyword: string, locationText: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    methodDoesNotExistOnType: (methodName: string, className: string) => {
+    __unused8: (methodName: string, className: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
     };
     duplicateIdentifier: (memberName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     missingOverrideKeyword: (ancestorClassName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    duplicateClassDeclaration: (scopeName: string, className: string) => {
+    nameCollision: (thisThingKind: string, thatThingKind: string, thatThingName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    classCouldNotBeFound: (className: string, scopeName: string) => {
+    __unused9: (className: string, scopeName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
         data: {
             className: string;
         };
     };
-    expectedClassFieldIdentifier: () => {
+    __unused27: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expressionIsNotConstructable: (expressionType: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedClassKeyword: () => {
+    expectedKeyword: (kind: TokenKind) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedLeftParenAfterCallable: (callableType: string) => {
+    __unused28: (callableType: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedNameAfterCallableKeyword: (callableType: string) => {
+    __unused29: (callableType: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedLeftParenAfterCallableName: (callableType: string) => {
+    __unused30: (callableType: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     tooManyCallableParameters: (actual: number, max: number) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    invalidFunctionReturnType: (typeText: string) => {
+    __unused: (typeText: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
     };
     requiredParameterMayNotFollowOptionalParameter: (parameterName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedNewlineOrColon: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    functionNameCannotEndWithTypeDesignator: (callableType: string, name: string, designator: string) => {
+    invalidIdentifier: (name: string, character: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    callableBlockMissingEndKeyword: (callableType: string) => {
+    __unused31: (callableType: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    mismatchedEndCallableKeyword: (expectedCallableType: string, actualCallableType: string) => {
+    closingKeywordMismatch: (expectedCallableType: string, actualCallableType: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedParameterNameButFound: (text: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    functionParameterTypeIsInvalid: (parameterName: string, typeText: string) => {
+    __unused2: (parameterName: string, typeText: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
     };
     cannotUseReservedWordAsIdentifier: (name: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedOperatorAfterIdentifier: (operators: TokenKind[], name: string) => {
+    expectedOperator: (operators: TokenKind[], name: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedInlineIfStatement: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedFinalNewline: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     couldNotFindMatchingEndKeyword: (keyword: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedCatchBlockInTryCatch: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedEndForOrNextToTerminateForLoop: () => {
+    expectedEndForOrNextToTerminateForLoop: (forLoopNameText?: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedInAfterForEach: (name: string) => {
+    __unused32: (name: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedExpressionAfterForEachIn: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     unexpectedColonBeforeIfStatement: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedStringLiteralAfterKeyword: (keyword: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     keywordMustBeDeclaredAtRootLevel: (keyword: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    __unused5: () => {
+        message: string;
+        legacyCode: number;
         severity: 1;
     };
-    libraryStatementMustBeDeclaredAtTopOfFile: () => {
+    expectedTerminator: (expectedTerminators: string[] | string, statementType: string, blockDescriptor?: 'block' | 'statement') => {
         message: string;
-        code: number;
         severity: 1;
+        code: string;
     };
-    expectedEndIfElseIfOrElseToTerminateThenBlock: () => {
+    __unused14: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedEndTryToTerminateTryCatch: () => {
+    __unused15: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedEndIfToCloseIfStatement: (startingPosition: Position) => {
+    __unused16: (startingPosition: Position) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedStatementToFollowConditionalCondition: (conditionType: string) => {
+    expectedStatement: (conditionType?: string, extraDetail?: string) => {
         message: string;
-        code: number;
         severity: 1;
+        code: string;
     };
-    expectedStatementToFollowElse: () => {
+    __unused18: (conditionType: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    consecutiveIncrementDecrementOperatorsAreNotAllowed: () => {
+    __unused19: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    incrementDecrementOperatorsAreNotAllowedAsResultOfFunctionCall: () => {
+    unexpectedOperator: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
+    };
+    __unused13: () => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
     };
     xmlUnexpectedTag: (tagName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedStatementOrFunctionCallButReceivedExpression: () => {
+    expectedStatementOrFunctionCallButReceivedExpression: (expressionType?: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     xmlFunctionNotFound: (name: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     xmlInvalidFieldType: (name: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     xmlUnexpectedChildren: (tagName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     xmlTagMissingAttribute: (tagName: string, attrName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedLabelIdentifierAfterGotoKeyword: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedRightSquareBraceAfterArrayOrObjectIndex: () => {
+    __unused26: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedPropertyNameAfterPeriod: () => {
+    __unused21: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     tooManyCallableArguments: (actual: number, max: number) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedRightParenAfterFunctionCallArguments: () => {
+    /**
+     * @param unmatchedToken Should be one of '(', '[', or '{'
+     * @param afterDetail any additional message to describe what came before the unmatched token
+     */
+    unmatchedLeftToken: (unmatchedToken: string, afterDetail?: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    unmatchedLeftParenAfterExpression: () => {
+    __unused23: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    unmatchedLeftSquareBraceAfterArrayLiteral: () => {
+    __unused24: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     unexpectedAAKey: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedColonBetweenAAKeyAndvalue: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    unmatchedLeftCurlyAfterAALiteral: () => {
+    __unused25: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    foundUnexpectedToken: (text: string) => {
+    unexpectedToken: (text: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     /**
      * Used in the lexer anytime we encounter an unsupported character
      */
     unexpectedCharacter: (text: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    unterminatedStringAtEndOfLine: () => {
+    unterminatedString: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    unterminatedStringAtEndOfFile: () => {
+    __unused33: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    fractionalHexLiteralsAreNotSupported: () => {
+    __unused44: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     unexpectedConditionalCompilationString: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     duplicateConstDeclaration: (name: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    constAliasDoesNotExist: (name: string) => {
+    __unused34: (name: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     invalidHashConstValue: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    referencedConstDoesNotExist: () => {
+    hashConstDoesNotExist: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     invalidHashIfValue: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
+    /**
+     * Treat #error directives like diagnostics, because the presence of `#error` even inside a runtime logical block that evaluates to false will 100% cause a compile error.
+     */
     hashError: (message: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedEqualAfterConstName: () => {
+    __unused43: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedHashElseIfToCloseHashIf: (startingLine: number) => {
+    __unused17: (startingLine: number) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    constNameCannotBeReservedWord: () => {
+    __unused35: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedIdentifier: () => {
+    __unused22: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     expectedAttributeNameAfterAtSymbol: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     childFieldTypeNotAssignableToBaseProperty: (childTypeName: string, baseTypeName: string, fieldName: string, childFieldType: string, parentFieldType: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    classChildMemberDifferentMemberTypeThanAncestor: (memberType: string, parentMemberType: string, parentClassName: string) => {
+    __unused36: (memberType: string, parentMemberType: string, parentClassName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     classConstructorMissingSuperCall: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     classConstructorIllegalUseOfMBeforeSuperCall: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     classFieldCannotBeOverridden: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     unusedAnnotation: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     localVarShadowedByScopedFunction: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     scopeFunctionShadowedByBuiltInFunction: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    localVarSameNameAsClass: (className: string) => {
+    __unused38: (className: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     unnecessaryCodebehindScriptImport: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 2;
+        code: string;
     };
-    expectedOpenParenToFollowCallfuncIdentifier: () => {
+    __unused37: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    expectedTokenAButFoundTokenB: (tokenA: string, tokenB: string) => {
+    expectedToken: (...tokenKinds: string[]) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    parameterMayNotHaveSameNameAsNamespace: (paramName: string) => {
+    __unused10: (paramName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    variableMayNotHaveSameNameAsNamespace: (variableName: string) => {
+    __unused11: (variableName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    unterminatedTemplateStringAtEndOfFile: () => {
+    unterminatedTemplateString: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     unterminatedTemplateExpression: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     duplicateComponentName: (componentName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    functionCannotHaveSameNameAsClass: (className: string) => {
+    __unused6: (className: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
     };
-    missingExceptionVarToFollowCatch: () => {
+    expectedExceptionVarToFollowCatch: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     missingExceptionExpressionAfterThrowKeyword: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    missingLeftSquareBracketAfterDimIdentifier: () => {
+    __unused42: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    missingRightSquareBracketAfterDimIdentifier: () => {
+    __unused39: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     missingExpressionsInDimStatement: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
     mismatchedOverriddenMemberVisibility: (childClassName: string, memberName: string, childAccessModifier: string, ancestorAccessModifier: string, ancestorClassName: string) => {
         message: string;
-        code: number;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    __unused3: (typeName: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+    };
+    enumValueMustBeType: (expectedType: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    enumValueIsRequired: (expectedType: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    __unused40: (name: string, enumName: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    __unused7: (scopeName: string, enumName: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+    };
+    unknownRoSGNode: (nodeName: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    unknownBrightScriptComponent: (componentName: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    mismatchCreateObjectArgumentCount: (componentName: string, allowedArgCounts: number[], actualCount: number) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    __unused41: (componentName: string, deprecatedDescription?: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    circularReferenceDetected: (items?: string | string[]) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    unexpectedStatementOutsideFunction: () => {
+        message: string;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    cannotFindType: (typeName: string) => {
+    detectedTooDeepFileSource: (numberOfParentDirectories: number) => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
     };
-    argumentTypeMismatch: (actualTypeString: string, expectedTypeString: string) => {
+    illegalContinueStatement: () => {
         message: string;
-        code: number;
+        legacyCode: number;
         severity: 1;
+        code: string;
+    };
+    keywordMustBeDeclaredAtNamespaceLevel: (keyword: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    itemCannotBeUsedAsVariable: (itemType: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    callfuncHasToManyArgs: (numberOfArgs: number) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    noOptionalChainingInLeftHandSideOfAssignment: () => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    /**
+     * @param name for function calls where we can't find the name of the function
+     * @param fullName if a namespaced name, this is the full name `alpha.beta.charlie`, otherwise it's the same as `name`
+     * @param typeName if 'name' refers to a member, what is the the type it is a member of?
+     * @param typeDescriptor defaults to 'type' ... could also be 'namespace', etc.
+     */
+    cannotFindFunction: (name: string, fullName?: string, typeName?: string, typeDescriptor?: string) => {
+        message: string;
+        legacyCode: number;
+        data: {
+            name: string;
+            fullName: string;
+            typeName: string;
+        };
+        severity: 1;
+        code: string;
+    };
+    voidFunctionMayNotReturnValue: (functionType?: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    nonVoidFunctionMustReturnValue: (functionType?: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    assignmentTypeMismatch: (actualTypeString: string, expectedTypeString: string, data?: TypeCompatibilityData) => {
+        message: string;
+        data: TypeCompatibilityData;
+        severity: 1;
+        code: string;
+    };
+    operatorTypeMismatch: (operatorString: string, firstType: string, secondType?: string) => {
+        message: string;
+        severity: 1;
+        code: string;
+    };
+    incompatibleSymbolDefinition: (symbol: string, options?: {
+        scopes?: string[];
+        isUnion?: boolean;
+        types?: BscType[];
+        data?: TypeCompatibilityData;
+    }) => {
+        message: string;
+        severity: 1;
+        code: string;
+    };
+    memberAccessibilityMismatch: (memberName: string, accessModifierFlag: SymbolTypeFlag, definingClassName: string) => {
+        message: string;
+        severity: 1;
+        code: string;
+    };
+    invalidTypecastStatementApplication: (foundApplication: string, isInFunctionBlock: boolean) => {
+        message: string;
+        severity: 1;
+        code: string;
+    };
+    itemCannotBeUsedAsType: (typeText: string) => {
+        message: string;
+        severity: 1;
+        code: string;
+    };
+    unsafeUnmatchedTerminatorInConditionalCompileBlock: (terminator: string) => {
+        message: string;
+        severity: 1;
+        code: string;
+    };
+    returnTypeCoercionMismatch: (returnType?: string) => {
+        message: string;
+        severity: 1;
+        code: string;
+    };
+    argumentTypeMismatch: (actualTypeString: string, expectedTypeString: string, data?: TypeCompatibilityData) => {
+        message: string;
+        data: TypeCompatibilityData;
+        severity: 1;
+        code: string;
+    };
+    returnTypeMismatch: (actualTypeString: string, expectedTypeString: string, data?: TypeCompatibilityData) => {
+        message: string;
+        data: TypeCompatibilityData;
+        severity: 1;
+        code: string;
+    };
+    cannotFindCallFuncFunction: (name: string, fullName: string, typeName: string) => {
+        message: string;
+        data: {
+            name: string;
+            fullName: string;
+            typeName: string;
+            isCallfunc: boolean;
+        };
+        severity: 1;
+        code: string;
+    };
+    notCallable: (name: string) => {
+        message: string;
+        severity: 1;
+        code: string;
+    };
+    notIterable: (typeName: string) => {
+        message: string;
+        severity: 1;
+        code: string;
+    };
+    propAccessNotPermittedAfterFunctionCallInExpressionStatement: (accessDescription: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    computedPropertyKeyMustBeConstantExpression: () => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    computedAAKeyMustBeStringExpression: () => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    featureRequiresMinFirmwareVersion: (featureName: string, minimumVersion: string, configuredVersion: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    reservedBuiltinUsedAsValue: (name: string) => {
+        message: string;
+        legacyCode: number;
+        severity: 1;
+        code: string;
+    };
+    /**
+     * Emitted when a block recovers from a wrong terminator (e.g. `while ... next` or `for ... end while`).
+     * `expected` lists the legal terminators in preferred-first order; `found` is the actual text.
+     * Quick fixes consume the structured `data` to build "Convert '<found>' to '<expected[i]>'" actions.
+     */
+    mismatchedEndingToken: (expected?: string[], found?: string) => {
+        message: string;
+        legacyCode: number;
+        data: {
+            expected: string[];
+            found: string;
+        };
+        severity: 1;
+        code: string;
     };
 };
-export declare const DiagnosticCodeMap: Record<"genericParserMessage" | "callToUnknownFunction" | "mismatchArgumentCount" | "duplicateFunctionImplementation" | "referencedFileDoesNotExist" | "xmlComponentMissingComponentDeclaration" | "xmlComponentMissingNameAttribute" | "xmlComponentMissingExtendsAttribute" | "xmlGenericParseError" | "unnecessaryScriptImportInChildFromParent" | "overridesAncestorFunction" | "localVarFunctionShadowsParentFunction" | "scriptImportCaseMismatch" | "fileNotReferencedByAnyOtherFile" | "unknownDiagnosticCode" | "scriptSrcCannotBeEmpty" | "expectedIdentifierAfterKeyword" | "missingCallableKeyword" | "expectedValidTypeToFollowAsKeyword" | "bsFeatureNotSupportedInBrsFiles" | "brsConfigJsonIsDeprecated" | "bsConfigJsonHasSyntaxErrors" | "namespacedClassCannotShareNamewithNonNamespacedClass" | "cannotUseOverrideKeywordOnConstructorFunction" | "importStatementMustBeDeclaredAtTopOfFile" | "methodDoesNotExistOnType" | "duplicateIdentifier" | "missingOverrideKeyword" | "duplicateClassDeclaration" | "classCouldNotBeFound" | "expectedClassFieldIdentifier" | "expressionIsNotConstructable" | "expectedClassKeyword" | "expectedLeftParenAfterCallable" | "expectedNameAfterCallableKeyword" | "expectedLeftParenAfterCallableName" | "tooManyCallableParameters" | "invalidFunctionReturnType" | "requiredParameterMayNotFollowOptionalParameter" | "expectedNewlineOrColon" | "functionNameCannotEndWithTypeDesignator" | "callableBlockMissingEndKeyword" | "mismatchedEndCallableKeyword" | "expectedParameterNameButFound" | "functionParameterTypeIsInvalid" | "cannotUseReservedWordAsIdentifier" | "expectedOperatorAfterIdentifier" | "expectedInlineIfStatement" | "expectedFinalNewline" | "couldNotFindMatchingEndKeyword" | "expectedCatchBlockInTryCatch" | "expectedEndForOrNextToTerminateForLoop" | "expectedInAfterForEach" | "expectedExpressionAfterForEachIn" | "unexpectedColonBeforeIfStatement" | "expectedStringLiteralAfterKeyword" | "keywordMustBeDeclaredAtRootLevel" | "libraryStatementMustBeDeclaredAtTopOfFile" | "expectedEndIfElseIfOrElseToTerminateThenBlock" | "expectedEndTryToTerminateTryCatch" | "expectedEndIfToCloseIfStatement" | "expectedStatementToFollowConditionalCondition" | "expectedStatementToFollowElse" | "consecutiveIncrementDecrementOperatorsAreNotAllowed" | "incrementDecrementOperatorsAreNotAllowedAsResultOfFunctionCall" | "xmlUnexpectedTag" | "expectedStatementOrFunctionCallButReceivedExpression" | "xmlFunctionNotFound" | "xmlInvalidFieldType" | "xmlUnexpectedChildren" | "xmlTagMissingAttribute" | "expectedLabelIdentifierAfterGotoKeyword" | "expectedRightSquareBraceAfterArrayOrObjectIndex" | "expectedPropertyNameAfterPeriod" | "tooManyCallableArguments" | "expectedRightParenAfterFunctionCallArguments" | "unmatchedLeftParenAfterExpression" | "unmatchedLeftSquareBraceAfterArrayLiteral" | "unexpectedAAKey" | "expectedColonBetweenAAKeyAndvalue" | "unmatchedLeftCurlyAfterAALiteral" | "foundUnexpectedToken" | "unexpectedCharacter" | "unterminatedStringAtEndOfLine" | "unterminatedStringAtEndOfFile" | "fractionalHexLiteralsAreNotSupported" | "unexpectedConditionalCompilationString" | "duplicateConstDeclaration" | "constAliasDoesNotExist" | "invalidHashConstValue" | "referencedConstDoesNotExist" | "invalidHashIfValue" | "hashError" | "expectedEqualAfterConstName" | "expectedHashElseIfToCloseHashIf" | "constNameCannotBeReservedWord" | "expectedIdentifier" | "expectedAttributeNameAfterAtSymbol" | "childFieldTypeNotAssignableToBaseProperty" | "classChildMemberDifferentMemberTypeThanAncestor" | "classConstructorMissingSuperCall" | "classConstructorIllegalUseOfMBeforeSuperCall" | "classFieldCannotBeOverridden" | "unusedAnnotation" | "localVarShadowedByScopedFunction" | "scopeFunctionShadowedByBuiltInFunction" | "localVarSameNameAsClass" | "unnecessaryCodebehindScriptImport" | "expectedOpenParenToFollowCallfuncIdentifier" | "expectedTokenAButFoundTokenB" | "parameterMayNotHaveSameNameAsNamespace" | "variableMayNotHaveSameNameAsNamespace" | "unterminatedTemplateStringAtEndOfFile" | "unterminatedTemplateExpression" | "duplicateComponentName" | "functionCannotHaveSameNameAsClass" | "missingExceptionVarToFollowCatch" | "missingExceptionExpressionAfterThrowKeyword" | "missingLeftSquareBracketAfterDimIdentifier" | "missingRightSquareBracketAfterDimIdentifier" | "missingExpressionsInDimStatement" | "mismatchedOverriddenMemberVisibility" | "cannotFindType" | "argumentTypeMismatch", number>;
-export declare let diagnosticCodes: number[];
+export declare const defaultMaximumTruncationLength = 160;
+export declare function typeCompatibilityMessage(actualTypeString: string, expectedTypeString: string, data: TypeCompatibilityData): string;
+export declare function incompatibleSymbolMessage(symbolName: string, options: {
+    scopes?: string[];
+    isUnion?: boolean;
+    data?: TypeCompatibilityData;
+}): string;
+export declare const DiagnosticCodeMap: Record<"genericParserMessage" | "cannotFindName" | "mismatchArgumentCount" | "duplicateFunctionImplementation" | "referencedFileDoesNotExist" | "xmlComponentMissingComponentDeclaration" | "xmlComponentMissingNameAttribute" | "xmlComponentMissingExtendsAttribute" | "syntaxError" | "unnecessaryScriptImportInChildFromParent" | "overridesAncestorFunction" | "localVarFunctionShadowsParentFunction" | "scriptImportCaseMismatch" | "fileNotReferencedByAnyOtherFile" | "unknownDiagnosticCode" | "scriptSrcCannotBeEmpty" | "expectedIdentifier" | "missingCallableKeyword" | "__unused12" | "bsFeatureNotSupportedInBrsFiles" | "__ununsed12" | "bsConfigJsonHasSyntaxErrors" | "itemIsDeprecated" | "cannotUseOverrideKeywordOnConstructorFunction" | "unexpectedStatementLocation" | "__unused8" | "duplicateIdentifier" | "missingOverrideKeyword" | "nameCollision" | "__unused9" | "__unused27" | "expressionIsNotConstructable" | "expectedKeyword" | "__unused28" | "__unused29" | "__unused30" | "tooManyCallableParameters" | "__unused" | "requiredParameterMayNotFollowOptionalParameter" | "expectedNewlineOrColon" | "invalidIdentifier" | "__unused31" | "closingKeywordMismatch" | "expectedParameterNameButFound" | "__unused2" | "cannotUseReservedWordAsIdentifier" | "expectedOperator" | "expectedInlineIfStatement" | "expectedFinalNewline" | "couldNotFindMatchingEndKeyword" | "expectedCatchBlockInTryCatch" | "expectedEndForOrNextToTerminateForLoop" | "__unused32" | "expectedExpressionAfterForEachIn" | "unexpectedColonBeforeIfStatement" | "expectedStringLiteralAfterKeyword" | "keywordMustBeDeclaredAtRootLevel" | "__unused5" | "expectedTerminator" | "__unused14" | "__unused15" | "__unused16" | "expectedStatement" | "__unused18" | "__unused19" | "unexpectedOperator" | "__unused13" | "xmlUnexpectedTag" | "expectedStatementOrFunctionCallButReceivedExpression" | "xmlFunctionNotFound" | "xmlInvalidFieldType" | "xmlUnexpectedChildren" | "xmlTagMissingAttribute" | "expectedLabelIdentifierAfterGotoKeyword" | "__unused26" | "__unused21" | "tooManyCallableArguments" | "unmatchedLeftToken" | "__unused23" | "__unused24" | "unexpectedAAKey" | "expectedColonBetweenAAKeyAndvalue" | "__unused25" | "unexpectedToken" | "unexpectedCharacter" | "unterminatedString" | "__unused33" | "__unused44" | "unexpectedConditionalCompilationString" | "duplicateConstDeclaration" | "__unused34" | "invalidHashConstValue" | "hashConstDoesNotExist" | "invalidHashIfValue" | "hashError" | "__unused43" | "__unused17" | "__unused35" | "__unused22" | "expectedAttributeNameAfterAtSymbol" | "childFieldTypeNotAssignableToBaseProperty" | "__unused36" | "classConstructorMissingSuperCall" | "classConstructorIllegalUseOfMBeforeSuperCall" | "classFieldCannotBeOverridden" | "unusedAnnotation" | "localVarShadowedByScopedFunction" | "scopeFunctionShadowedByBuiltInFunction" | "__unused38" | "unnecessaryCodebehindScriptImport" | "__unused37" | "expectedToken" | "__unused10" | "__unused11" | "unterminatedTemplateString" | "unterminatedTemplateExpression" | "duplicateComponentName" | "__unused6" | "expectedExceptionVarToFollowCatch" | "missingExceptionExpressionAfterThrowKeyword" | "__unused42" | "__unused39" | "missingExpressionsInDimStatement" | "mismatchedOverriddenMemberVisibility" | "__unused3" | "enumValueMustBeType" | "enumValueIsRequired" | "__unused40" | "__unused7" | "unknownRoSGNode" | "unknownBrightScriptComponent" | "mismatchCreateObjectArgumentCount" | "__unused41" | "circularReferenceDetected" | "unexpectedStatementOutsideFunction" | "detectedTooDeepFileSource" | "illegalContinueStatement" | "keywordMustBeDeclaredAtNamespaceLevel" | "itemCannotBeUsedAsVariable" | "callfuncHasToManyArgs" | "noOptionalChainingInLeftHandSideOfAssignment" | "cannotFindFunction" | "voidFunctionMayNotReturnValue" | "nonVoidFunctionMustReturnValue" | "assignmentTypeMismatch" | "operatorTypeMismatch" | "incompatibleSymbolDefinition" | "memberAccessibilityMismatch" | "invalidTypecastStatementApplication" | "itemCannotBeUsedAsType" | "unsafeUnmatchedTerminatorInConditionalCompileBlock" | "returnTypeCoercionMismatch" | "argumentTypeMismatch" | "returnTypeMismatch" | "cannotFindCallFuncFunction" | "notCallable" | "notIterable" | "propAccessNotPermittedAfterFunctionCallInExpressionStatement" | "computedPropertyKeyMustBeConstantExpression" | "computedAAKeyMustBeStringExpression" | "featureRequiresMinFirmwareVersion" | "reservedBuiltinUsedAsValue" | "mismatchedEndingToken", string>;
+export declare const DiagnosticLegacyCodeMap: Record<"genericParserMessage" | "cannotFindName" | "mismatchArgumentCount" | "duplicateFunctionImplementation" | "referencedFileDoesNotExist" | "xmlComponentMissingComponentDeclaration" | "xmlComponentMissingNameAttribute" | "xmlComponentMissingExtendsAttribute" | "syntaxError" | "unnecessaryScriptImportInChildFromParent" | "overridesAncestorFunction" | "localVarFunctionShadowsParentFunction" | "scriptImportCaseMismatch" | "fileNotReferencedByAnyOtherFile" | "unknownDiagnosticCode" | "scriptSrcCannotBeEmpty" | "expectedIdentifier" | "missingCallableKeyword" | "__unused12" | "bsFeatureNotSupportedInBrsFiles" | "__ununsed12" | "bsConfigJsonHasSyntaxErrors" | "itemIsDeprecated" | "cannotUseOverrideKeywordOnConstructorFunction" | "unexpectedStatementLocation" | "__unused8" | "duplicateIdentifier" | "missingOverrideKeyword" | "nameCollision" | "__unused9" | "__unused27" | "expressionIsNotConstructable" | "expectedKeyword" | "__unused28" | "__unused29" | "__unused30" | "tooManyCallableParameters" | "__unused" | "requiredParameterMayNotFollowOptionalParameter" | "expectedNewlineOrColon" | "invalidIdentifier" | "__unused31" | "closingKeywordMismatch" | "expectedParameterNameButFound" | "__unused2" | "cannotUseReservedWordAsIdentifier" | "expectedOperator" | "expectedInlineIfStatement" | "expectedFinalNewline" | "couldNotFindMatchingEndKeyword" | "expectedCatchBlockInTryCatch" | "expectedEndForOrNextToTerminateForLoop" | "__unused32" | "expectedExpressionAfterForEachIn" | "unexpectedColonBeforeIfStatement" | "expectedStringLiteralAfterKeyword" | "keywordMustBeDeclaredAtRootLevel" | "__unused5" | "expectedTerminator" | "__unused14" | "__unused15" | "__unused16" | "expectedStatement" | "__unused18" | "__unused19" | "unexpectedOperator" | "__unused13" | "xmlUnexpectedTag" | "expectedStatementOrFunctionCallButReceivedExpression" | "xmlFunctionNotFound" | "xmlInvalidFieldType" | "xmlUnexpectedChildren" | "xmlTagMissingAttribute" | "expectedLabelIdentifierAfterGotoKeyword" | "__unused26" | "__unused21" | "tooManyCallableArguments" | "unmatchedLeftToken" | "__unused23" | "__unused24" | "unexpectedAAKey" | "expectedColonBetweenAAKeyAndvalue" | "__unused25" | "unexpectedToken" | "unexpectedCharacter" | "unterminatedString" | "__unused33" | "__unused44" | "unexpectedConditionalCompilationString" | "duplicateConstDeclaration" | "__unused34" | "invalidHashConstValue" | "hashConstDoesNotExist" | "invalidHashIfValue" | "hashError" | "__unused43" | "__unused17" | "__unused35" | "__unused22" | "expectedAttributeNameAfterAtSymbol" | "childFieldTypeNotAssignableToBaseProperty" | "__unused36" | "classConstructorMissingSuperCall" | "classConstructorIllegalUseOfMBeforeSuperCall" | "classFieldCannotBeOverridden" | "unusedAnnotation" | "localVarShadowedByScopedFunction" | "scopeFunctionShadowedByBuiltInFunction" | "__unused38" | "unnecessaryCodebehindScriptImport" | "__unused37" | "expectedToken" | "__unused10" | "__unused11" | "unterminatedTemplateString" | "unterminatedTemplateExpression" | "duplicateComponentName" | "__unused6" | "expectedExceptionVarToFollowCatch" | "missingExceptionExpressionAfterThrowKeyword" | "__unused42" | "__unused39" | "missingExpressionsInDimStatement" | "mismatchedOverriddenMemberVisibility" | "__unused3" | "enumValueMustBeType" | "enumValueIsRequired" | "__unused40" | "__unused7" | "unknownRoSGNode" | "unknownBrightScriptComponent" | "mismatchCreateObjectArgumentCount" | "__unused41" | "circularReferenceDetected" | "unexpectedStatementOutsideFunction" | "detectedTooDeepFileSource" | "illegalContinueStatement" | "keywordMustBeDeclaredAtNamespaceLevel" | "itemCannotBeUsedAsVariable" | "callfuncHasToManyArgs" | "noOptionalChainingInLeftHandSideOfAssignment" | "cannotFindFunction" | "voidFunctionMayNotReturnValue" | "nonVoidFunctionMustReturnValue" | "assignmentTypeMismatch" | "operatorTypeMismatch" | "incompatibleSymbolDefinition" | "memberAccessibilityMismatch" | "invalidTypecastStatementApplication" | "itemCannotBeUsedAsType" | "unsafeUnmatchedTerminatorInConditionalCompileBlock" | "returnTypeCoercionMismatch" | "argumentTypeMismatch" | "returnTypeMismatch" | "cannotFindCallFuncFunction" | "notCallable" | "notIterable" | "propAccessNotPermittedAfterFunctionCallInExpressionStatement" | "computedPropertyKeyMustBeConstantExpression" | "computedAAKeyMustBeStringExpression" | "featureRequiresMinFirmwareVersion" | "reservedBuiltinUsedAsValue" | "mismatchedEndingToken", number>;
+export declare let diagnosticCodes: string[];
 export interface DiagnosticInfo {
     message: string;
-    code: number;
+    legacyCode: number;
     severity: DiagnosticSeverity;
 }
 /**
@@ -648,4 +1047,11 @@ export interface DiagnosticInfo {
  * The second type parameter is optional, but allows plugins to pass in their own
  * DiagnosticMessages-like object in order to get the same type support
  */
-export declare type DiagnosticMessageType<K extends keyof D, D extends Record<string, (...args: any) => any> = typeof DiagnosticMessages> = ReturnType<D[K]> & Pick<BsDiagnostic, 'range' | 'file' | 'relatedInformation' | 'tags'>;
+export declare type DiagnosticMessageType<K extends keyof D, D extends Record<string, (...args: any) => any> = typeof DiagnosticMessages> = ReturnType<D[K]> & Pick<BsDiagnostic, 'code' | 'location' | 'relatedInformation' | 'tags'>;
+/**
+ * Refines a diagnostic to its concrete `DiagnosticMessageType<K>` shape (including the typed `data`
+ * payload) when its code matches `DiagnosticCodeMap[key]`.
+ */
+export declare function isDiagnosticOfType<K extends keyof typeof DiagnosticMessages>(diagnostic: {
+    code?: number | string;
+}, key: K): diagnostic is DiagnosticMessageType<K>;