brighterscript 1.0.0-alpha.40 → 1.0.0-alpha.42

package/dist/DiagnosticMessages.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.diagnosticCodes = exports.DiagnosticCodeMap = exports.typeCompatibilityMessage = exports.defaultMaximumTruncationLength = exports.DiagnosticMessages = void 0;
+exports.diagnosticCodes = exports.DiagnosticLegacyCodeMap = exports.DiagnosticCodeMap = exports.typeCompatibilityMessage = exports.defaultMaximumTruncationLength = exports.DiagnosticMessages = exports.DiagnosticCodeRegex = void 0;
 const vscode_languageserver_1 = require("vscode-languageserver");
 const TokenKind_1 = require("./lexer/TokenKind");
 const util_1 = require("./util");
+exports.DiagnosticCodeRegex = /^[a-z](?:[a-z0-9]*(?:-[a-z0-9]+)*)*$/;
 /**
  * An object that keeps track of all possible error messages.
  */
@@ -11,8 +12,9 @@ exports.DiagnosticMessages = {
     //this one won't be used much, we just need a catchall object for the code since we pass through the message from the parser
     genericParserMessage: (message) => ({
         message: message,
-        code: 1000,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1000,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'generic-parser-message'
     }),
     /**
      *
@@ -23,711 +25,907 @@ exports.DiagnosticMessages = {
      */
     cannotFindName: (name, fullName, typeName, typeDescriptor = 'type') => ({
         message: `Cannot find name '${name}'${typeName ? ` for ${typeDescriptor} '${typeName}'` : ''}`,
-        code: 1001,
+        legacyCode: 1001,
         data: {
             name: name,
             fullName: fullName !== null && fullName !== void 0 ? fullName : name,
             typeName: typeName ? typeName : undefined
         },
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'cannot-find-name'
     }),
     mismatchArgumentCount: (expectedCount, actualCount) => ({
         message: `Expected ${expectedCount} arguments, but got ${actualCount}.`,
-        code: 1002,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1002,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'incorrect-argument-count'
     }),
     duplicateFunctionImplementation: (functionName) => ({
         message: `Duplicate function implementation for '${functionName}'.`,
-        code: 1003,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1003,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'duplicate-function'
     }),
     referencedFileDoesNotExist: () => ({
         message: `Referenced file does not exist.`,
-        code: 1004,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1004,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'file-not-found'
     }),
     xmlComponentMissingComponentDeclaration: () => ({
         message: `Missing a component declaration.`,
-        code: 1005,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1005,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'missing-component-element'
     }),
     xmlComponentMissingNameAttribute: () => ({
         message: `Component must have a name attribute.`,
-        code: 1006,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1006,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'missing-name-attribute'
     }),
     xmlComponentMissingExtendsAttribute: () => ({
         message: `Component is mising "extends" attribute and will automatically extend "Group" by default`,
-        code: 1007,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Warning
+        legacyCode: 1007,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Warning,
+        code: 'missing-extends-attribute'
     }),
-    xmlGenericParseError: (message) => ({
+    syntaxError: (message) => ({
         //generic catchall xml parse error
         message: message,
-        code: 1008,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1008,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'syntax-error'
     }),
     unnecessaryScriptImportInChildFromParent: (parentComponentName) => ({
         message: `Unnecessary script import: Script is already imported in ancestor component '${parentComponentName}'.`,
-        code: 1009,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Warning
+        legacyCode: 1009,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Warning,
+        code: 'redundant-import'
     }),
     overridesAncestorFunction: (callableName, currentScopeName, parentFilePath, parentScopeName) => ({
         message: `Function '${callableName}' included in '${currentScopeName}' overrides function in '${parentFilePath}' included in '${parentScopeName}'.`,
-        code: 1010,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Hint
+        legacyCode: 1010,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Hint,
+        code: 'overrides-ancestor-function'
     }),
     localVarFunctionShadowsParentFunction: (scopeName) => ({
         message: `Local variable function has same name as ${scopeName} function and will never be called.`,
-        code: 1011,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Warning
+        legacyCode: 1011,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Warning,
+        code: 'variable-shadows-function'
     }),
     scriptImportCaseMismatch: (correctFilePath) => ({
         message: `Script import path does not match casing of actual file path '${correctFilePath}'.`,
-        code: 1012,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Warning
+        legacyCode: 1012,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Warning,
+        code: 'import-case-mismatch'
     }),
     fileNotReferencedByAnyOtherFile: () => ({
         message: `This file is not referenced by any other file in the project.`,
-        code: 1013,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Warning
+        legacyCode: 1013,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Warning,
+        code: 'file-not-referenced'
     }),
     unknownDiagnosticCode: (theUnknownCode) => ({
         message: `Unknown diagnostic code ${theUnknownCode}`,
-        code: 1014,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Warning
+        legacyCode: 1014,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Warning,
+        code: 'unknown-diagnostic-code'
     }),
     scriptSrcCannotBeEmpty: () => ({
         message: `Script import cannot be empty or whitespace`,
-        code: 1015,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
-    }),
-    expectedIdentifierAfterKeyword: (keywordText) => ({
-        message: `Expected identifier after '${keywordText}' keyword`,
-        code: 1016,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1015,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-import-path'
     }),
+    expectedIdentifier: (preceedingTokenText) => {
+        let message = `Expected identifier`;
+        if (preceedingTokenText) {
+            message += ` after '${preceedingTokenText}'`;
+        }
+        return {
+            message: message,
+            legacyCode: 1016,
+            severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+            code: 'expected-identifier'
+        };
+    },
     missingCallableKeyword: () => ({
-        message: `Expected 'function' or 'sub' to preceed identifier`,
-        code: 1017,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Expected 'function' or 'sub' to precede identifier`,
+        legacyCode: 1017,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-leading-keyword'
     }),
-    expectedValidTypeToFollowAsKeyword: () => ({
+    __unused12: () => ({
         message: `Expected valid type to follow 'as' keyword`,
-        code: 1018,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1018,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-valid-type'
     }),
     bsFeatureNotSupportedInBrsFiles: (featureName) => ({
         message: `BrighterScript feature '${featureName}' is not supported in standard BrightScript files`,
-        code: 1019,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1019,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'bs-feature-not-supported'
     }),
-    brsConfigJsonIsDeprecated: () => ({
+    __ununsed12: () => ({
         message: `'brsconfig.json' is deprecated. Please rename to 'bsconfig.json'`,
-        code: 1020,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Warning
+        legacyCode: 1020,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Warning,
+        code: 'brsconfig-deprecated'
     }),
     bsConfigJsonHasSyntaxErrors: (message) => ({
         message: `Encountered syntax errors in bsconfig.json: ${message}`,
-        code: 1021,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
-    }),
-    itemIsDeprecated: () => ({
-        message: `Item is deprecated`,
-        code: 1022,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Hint
+        legacyCode: 1021,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'bsconfig-syntax-errors'
     }),
+    itemIsDeprecated: (itemName, deprecatedDescription) => {
+        itemName !== null && itemName !== void 0 ? itemName : (itemName = 'Item');
+        return {
+            message: `${itemName} has been deprecated${deprecatedDescription ? ': ' + deprecatedDescription : ''} `,
+            legacyCode: 1022,
+            severity: vscode_languageserver_1.DiagnosticSeverity.Hint,
+            code: 'item-deprecated'
+        };
+    },
     cannotUseOverrideKeywordOnConstructorFunction: () => ({
         message: 'Override keyword is not allowed on class constructor method',
-        code: 1023,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1023,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'override-keyword-on-constructor'
     }),
-    statementMustBeDeclaredAtTopOfFile: (statementKeyword) => ({
-        message: `'${statementKeyword}' statement must be declared at the top of the file`,
-        code: 1024,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    unexpectedStatementLocation: (statementKeyword, locationText) => ({
+        message: `'${statementKeyword}' statement must be declared ${locationText}`,
+        legacyCode: 1024,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-statement-location'
     }),
-    methodDoesNotExistOnType: (methodName, className) => ({
+    __unused8: (methodName, className) => ({
         message: `Method '${methodName}' does not exist on type '${className}'`,
-        code: 1025,
+        legacyCode: 1025,
         severity: vscode_languageserver_1.DiagnosticSeverity.Error
     }),
     duplicateIdentifier: (memberName) => ({
         message: `Duplicate identifier '${memberName}'`,
-        code: 1026,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1026,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'duplicate-identifier'
     }),
     missingOverrideKeyword: (ancestorClassName) => ({
         message: `Method has no override keyword but is declared in ancestor class '${ancestorClassName}'`,
-        code: 1027,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1027,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'missing-override-keyword'
     }),
     nameCollision: (thisThingKind, thatThingKind, thatThingName) => ({
         message: `${thisThingKind} has same name as ${thatThingKind} '${thatThingName}'`,
-        code: 1028,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1028,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'name-collision'
     }),
-    classCouldNotBeFound: (className, scopeName) => ({
+    __unused9: (className, scopeName) => ({
         message: `Class '${className}' could not be found when this file is included in scope '${scopeName}'`,
-        code: 1029,
+        legacyCode: 1029,
         severity: vscode_languageserver_1.DiagnosticSeverity.Error,
         data: {
             className: className
         }
     }),
-    expectedClassFieldIdentifier: () => ({
+    __unused27: () => ({
         message: `Expected identifier in class body`,
-        code: 1030,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1030,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-identifier-in-body'
     }),
     expressionIsNotConstructable: (expressionType) => ({
         message: `Cannot use the 'new' keyword here because '${expressionType}' is not a constructable type`,
-        code: 1031,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1031,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'not-constructable'
     }),
     expectedKeyword: (kind) => ({
         message: `Expected '${kind}' keyword`,
-        code: 1032,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1032,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-keyword'
     }),
-    expectedLeftParenAfterCallable: (callableType) => ({
+    __unused28: (callableType) => ({
         message: `Expected '(' after ${callableType}`,
-        code: 1033,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1033,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-left-paren-after-callable'
     }),
-    expectedNameAfterCallableKeyword: (callableType) => ({
+    __unused29: (callableType) => ({
         message: `Expected ${callableType} name after '${callableType}' keyword`,
-        code: 1034,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1034,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-name-after-callable'
     }),
-    expectedLeftParenAfterCallableName: (callableType) => ({
+    __unused30: (callableType) => ({
         message: `Expected '(' after ${callableType} name`,
-        code: 1035,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1035,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-left-paren-after-callable-name'
     }),
     tooManyCallableParameters: (actual, max) => ({
         message: `Cannot have more than ${max} parameters but found ${actual})`,
-        code: 1036,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1036,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'exceeds-max-parameter-count'
     }),
     __unused: (typeText) => ({
         message: `Function return type '${typeText}' is invalid`,
-        code: 1037,
+        legacyCode: 1037,
         severity: vscode_languageserver_1.DiagnosticSeverity.Error
     }),
     requiredParameterMayNotFollowOptionalParameter: (parameterName) => ({
         message: `Required parameter '${parameterName}' must be declared before any optional parameters`,
-        code: 1038,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1038,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'required-parameter-before-optional'
     }),
     expectedNewlineOrColon: () => ({
         message: `Expected newline or ':' at the end of a statement`,
-        code: 1039,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1039,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-statement-separator'
     }),
-    functionNameCannotEndWithTypeDesignator: (callableType, name, designator) => ({
-        message: `${callableType} name '${name}' cannot end with type designator '${designator}'`,
-        code: 1040,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    invalidIdentifier: (name, character) => ({
+        message: `Identifier '${name}' may not contain the character '${character}'`,
+        legacyCode: 1040,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-identifier'
     }),
-    callableBlockMissingEndKeyword: (callableType) => ({
+    __unused31: (callableType) => ({
         message: `Expected 'end ${callableType}' to terminate ${callableType} block`,
-        code: 1041,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
-    }),
-    mismatchedEndCallableKeyword: (expectedCallableType, actualCallableType) => ({
-        message: `Expected 'end ${expectedCallableType === null || expectedCallableType === void 0 ? void 0 : expectedCallableType.replace(/^end\s*/, '')}' to terminate ${expectedCallableType} block but found 'end ${actualCallableType === null || actualCallableType === void 0 ? void 0 : actualCallableType.replace(/^end\s*/, '')}' instead.`,
-        code: 1042,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1041,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'closing-keyword-mismatch'
     }),
+    closingKeywordMismatch: (expectedCallableType, actualCallableType) => {
+        let message = `Expected 'end ${expectedCallableType === null || expectedCallableType === void 0 ? void 0 : expectedCallableType.replace(/^end\s*/, '')}' to terminate ${expectedCallableType} block`;
+        if (actualCallableType) {
+            message += ` but found 'end ${actualCallableType === null || actualCallableType === void 0 ? void 0 : actualCallableType.replace(/^end\s*/, '')}' instead.`;
+        }
+        return {
+            message: message,
+            legacyCode: 1042,
+            severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+            code: 'closing-keyword'
+        };
+    },
     expectedParameterNameButFound: (text) => ({
         message: `Expected parameter name, but found '${text !== null && text !== void 0 ? text : ''}'`,
-        code: 1043,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1043,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-parameter-name'
     }),
     __unused2: (parameterName, typeText) => ({
         message: `Function parameter '${parameterName}' is of invalid type '${typeText}'`,
-        code: 1044,
+        legacyCode: 1044,
         severity: vscode_languageserver_1.DiagnosticSeverity.Error
     }),
     cannotUseReservedWordAsIdentifier: (name) => ({
         message: `Cannot use reserved word '${name}' as an identifier`,
-        code: 1045,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1045,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'cannot-use-reserved-word'
     }),
-    expectedOperatorAfterIdentifier: (operators, name) => {
+    expectedOperator: (operators, name) => {
         operators = Array.isArray(operators) ? operators : [];
+        let message = `Expected operator ('${operators.join(`', '`)}')`;
+        if (name) {
+            message += ` after idenfifier '${name}'`;
+        }
         return {
-            message: `Expected operator ('${operators.join(`', '`)}') after idenfifier '${name}'`,
-            code: 1046,
-            severity: vscode_languageserver_1.DiagnosticSeverity.Error
+            message: message,
+            legacyCode: 1046,
+            severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+            code: 'expected-operator'
         };
     },
     expectedInlineIfStatement: () => ({
         message: `If/else statement within an inline if should be also inline`,
-        code: 1047,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1047,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'malformed-inline-if'
     }),
     expectedFinalNewline: () => ({
         message: `Expected newline at the end of an inline if statement`,
-        code: 1048,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1048,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-final-newline'
     }),
     couldNotFindMatchingEndKeyword: (keyword) => ({
         message: `Could not find matching 'end ${keyword}'`,
-        code: 1049,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1049,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-end-keyword'
     }),
     expectedCatchBlockInTryCatch: () => ({
         message: `Expected 'catch' block in 'try' statement`,
-        code: 1050,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1050,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-catch'
     }),
-    expectedEndForOrNextToTerminateForLoop: () => ({
-        message: `Expected 'end for' or 'next' to terminate 'for' loop`,
-        code: 1051,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    expectedEndForOrNextToTerminateForLoop: (forLoopNameText = TokenKind_1.TokenKind.For) => ({
+        message: `Expected 'end for' or 'next' to terminate '${forLoopNameText}' loop`,
+        legacyCode: 1051,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-loop-terminator'
     }),
-    expectedInAfterForEach: (name) => ({
+    __unused32: (name) => ({
         message: `Expected 'in' after 'for each ${name}'`,
-        code: 1052,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1052,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-in-for-each'
     }),
     expectedExpressionAfterForEachIn: () => ({
         message: `Expected expression after 'in' keyword from 'for each' statement`,
-        code: 1053,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1053,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-loop-expression'
     }),
     unexpectedColonBeforeIfStatement: () => ({
         message: `Colon before 'if' statement is not allowed`,
-        code: 1054,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1054,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-leading-colon'
     }),
     expectedStringLiteralAfterKeyword: (keyword) => ({
-        message: `Missing string literal after '${keyword}' keyword`,
-        code: 1055,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Expected string literal after '${keyword}' keyword`,
+        legacyCode: 1055,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-string-literal'
     }),
     keywordMustBeDeclaredAtRootLevel: (keyword) => ({
         message: `${keyword} must be declared at the root level`,
-        code: 1056,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1056,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'keyword-must-be-root-level'
     }),
     __unused5: () => ({
         message: `'library' statement must be declared at the top of the file`,
-        code: 1057,
+        legacyCode: 1057,
         severity: vscode_languageserver_1.DiagnosticSeverity.Error
     }),
-    expectedEndIfElseIfOrElseToTerminateThenBlock: () => ({
+    expectedTerminator: (expectedTerminators, statementType, blockDescriptor = 'statement') => ({
+        message: `Expected ${getPossibilitiesString(expectedTerminators)} to terminate '${statementType}' ${blockDescriptor}`,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-terminator'
+    }),
+    __unused14: () => ({
         message: `Expected 'end if', 'else if', or 'else' to terminate 'then' block`,
-        code: 1058,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1058,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-terminator-on-then'
     }),
-    expectedEndTryToTerminateTryCatch: () => ({
+    __unused15: () => ({
         message: `Expected 'end try' to terminate 'try-catch' statement`,
-        code: 1059,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1059,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-terminator-on-try-catch'
     }),
-    expectedEndIfToCloseIfStatement: (startingPosition) => ({
-        message: `Expected 'end if' to close 'if' statement started at ${(startingPosition === null || startingPosition === void 0 ? void 0 : startingPosition.line) + 1}:${(startingPosition === null || startingPosition === void 0 ? void 0 : startingPosition.character) + 1}`,
-        code: 1060,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    __unused16: (startingPosition) => ({
+        message: `Expected 'end if' to close 'if' statement started at ${(startingPosition === null || startingPosition === void 0 ? void 0 : startingPosition.line) + 1}:${(startingPosition === null || startingPosition === void 0 ? void 0 : startingPosition.character) + 1} `,
+        legacyCode: 1060,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-terminator-on-if'
     }),
-    expectedStatementToFollowConditionalCondition: (conditionType) => ({
+    expectedStatement: (conditionType, extraDetail) => {
+        let message = 'Expected statement';
+        if (conditionType) {
+            message += ` to follow '${conditionType === null || conditionType === void 0 ? void 0 : conditionType.toLowerCase()}'`;
+        }
+        if (extraDetail) {
+            message += ` ${extraDetail}`;
+        }
+        return {
+            message: message,
+            severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+            code: 'expected-statement'
+        };
+    },
+    __unused18: (conditionType) => ({
         message: `Expected a statement to follow '${conditionType === null || conditionType === void 0 ? void 0 : conditionType.toLowerCase()} ...condition... then'`,
-        code: 1061,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1061,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-statement-after-conditional'
     }),
-    expectedStatementToFollowElse: () => ({
+    __unused19: () => ({
         message: `Expected a statement to follow 'else'`,
-        code: 1062,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1062,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-statement-after-else'
     }),
-    consecutiveIncrementDecrementOperatorsAreNotAllowed: () => ({
-        message: `Consecutive increment/decrement operators are not allowed`,
-        code: 1063,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    unexpectedOperator: () => ({
+        message: `Unexpected operator`,
+        legacyCode: 1063,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-operator'
     }),
-    incrementDecrementOperatorsAreNotAllowedAsResultOfFunctionCall: () => ({
-        message: ``,
-        code: 1064,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    __unused13: () => ({
+        message: `Increment / decrement operators are not allowed on function calls`,
+        legacyCode: 1064,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'increment-decrement-on-function-call'
     }),
     xmlUnexpectedTag: (tagName) => ({
         message: `Unexpected tag '${tagName}'`,
-        code: 1065,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1065,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-tag'
     }),
-    expectedStatementOrFunctionCallButReceivedExpression: () => ({
+    __unused20: () => ({
         message: `Expected statement or function call but instead found expression`,
-        code: 1066,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1066,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-statement-not-expression'
     }),
     xmlFunctionNotFound: (name) => ({
         message: `Cannot find function with name '${name}' in component scope`,
-        code: 1067,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1067,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'function-not-found'
     }),
     xmlInvalidFieldType: (name) => ({
         message: `Invalid field type ${name}`,
-        code: 1068,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1068,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-field-type'
     }),
     xmlUnexpectedChildren: (tagName) => ({
         message: `Tag '${tagName}' should not have children`,
-        code: 1069,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1069,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-children'
     }),
     xmlTagMissingAttribute: (tagName, attrName) => ({
         message: `Tag '${tagName}' must have a '${attrName}' attribute`,
-        code: 1070,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1070,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-attribute'
     }),
     expectedLabelIdentifierAfterGotoKeyword: () => ({
         message: `Expected label identifier after 'goto' keyword`,
-        code: 1071,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1071,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-label'
     }),
-    expectedRightSquareBraceAfterArrayOrObjectIndex: () => ({
+    __unused26: () => ({
         message: `Expected ']' after array or object index`,
-        code: 1072,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1072,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-right-brace'
     }),
-    expectedPropertyNameAfterPeriod: () => ({
+    __unused21: () => ({
         message: `Expected property name after '.'`,
-        code: 1073,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1073,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-property-name'
     }),
     tooManyCallableArguments: (actual, max) => ({
-        message: `Cannot have more than ${max} arguments but found ${actual}`,
-        code: 1074,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
-    }),
-    expectedRightParenAfterFunctionCallArguments: () => ({
-        message: `Expected ')' after function call arguments`,
-        code: 1075,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Cannot have more than ${max} arguments but found ${actual} `,
+        legacyCode: 1074,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'exceeds-max-argument-count'
     }),
-    unmatchedLeftParenAfterExpression: () => ({
+    /**
+     * @param unmatchedToken Should be one of '(', '[', or '{'
+     * @param afterDetail any additional message to describe what came before the unmatched token
+     */
+    unmatchedLeftToken: (unmatchedToken, afterDetail = '') => {
+        let matchingToken = '';
+        switch (unmatchedToken) {
+            case '(':
+                matchingToken = ')';
+                break;
+            case '[':
+                matchingToken = ']';
+                break;
+            case '{':
+                matchingToken = '}';
+                break;
+        }
+        let message = `Unmatched '${unmatchedToken}'`;
+        if (matchingToken) {
+            message += `: expected '${matchingToken}'`;
+        }
+        if (afterDetail) {
+            message += ` after ${afterDetail}`;
+        }
+        return {
+            message: message,
+            legacyCode: 1075,
+            severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+            code: 'unmatched-left-token'
+        };
+    },
+    __unused23: () => ({
         message: `Unmatched '(': expected ')' after expression`,
-        code: 1076,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1076,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unmatched-left-paren'
     }),
-    unmatchedLeftSquareBraceAfterArrayLiteral: () => ({
+    __unused24: () => ({
         message: `Unmatched '[': expected ']' after array literal`,
-        code: 1077,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1077,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unmatched-left-brace'
     }),
     unexpectedAAKey: () => ({
         message: `Expected identifier or string as associative array key`,
-        code: 1078,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1078,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-aa-key'
     }),
     expectedColonBetweenAAKeyAndvalue: () => ({
         message: `Expected ':' between associative array key and value`,
-        code: 1079,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1079,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-aa-separator'
     }),
-    unmatchedLeftCurlyAfterAALiteral: () => ({
+    __unused25: () => ({
         message: `Unmatched '{': expected '}' after associative array literal`,
-        code: 1080,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1080,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unmatched-left-curly'
     }),
     unexpectedToken: (text) => ({
         message: `Unexpected token '${text}'`,
-        code: 1081,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1081,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-token'
     }),
     /**
      * Used in the lexer anytime we encounter an unsupported character
      */
     unexpectedCharacter: (text) => ({
-        message: `Unexpected character '${text}' (char code ${text === null || text === void 0 ? void 0 : text.charCodeAt(0)})`,
-        code: 1082,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Unexpected character '${text}'(char code ${text === null || text === void 0 ? void 0 : text.charCodeAt(0)})`,
+        legacyCode: 1082,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-character'
     }),
-    unterminatedStringAtEndOfLine: () => ({
-        message: `Unterminated string at end of line`,
-        code: 1083,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    unterminatedString: () => ({
+        message: `Unterminated string literal`,
+        legacyCode: 1083,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unterminated-string'
     }),
-    unterminatedStringAtEndOfFile: () => ({
+    __unused33: () => ({
         message: `Unterminated string at end of file`,
-        code: 1084,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1084,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unterminated-string-at-end-of-file'
     }),
-    fractionalHexLiteralsAreNotSupported: () => ({
+    __unused44: () => ({
         message: `Fractional hex literals are not supported`,
-        code: 1085,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1085,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'fractional-hex-literal'
     }),
     unexpectedConditionalCompilationString: () => ({
-        message: `Unexpected conditional-compilation string`,
-        code: 1086,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Unknown conditional compile keyword`,
+        legacyCode: 1086,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unknown-conditional-compile-keyword'
     }),
     duplicateConstDeclaration: (name) => ({
         message: `Attempting to redeclare #const with name '${name}'`,
-        code: 1087,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1087,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'duplicate-const-declaration'
     }),
-    constAliasDoesNotExist: (name) => ({
+    __unused34: (name) => ({
         message: `Attempting to create #const alias of '${name}', but no such #const exists`,
-        code: 1088,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1088,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'const-alias-does-not-exist'
     }),
     invalidHashConstValue: () => ({
         message: '#const declarations can only have values of `true`, `false`, or other #const names',
-        code: 1089,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1089,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-hash-const-value'
     }),
-    referencedConstDoesNotExist: () => ({
+    hashConstDoesNotExist: () => ({
         message: `Referenced #const does not exist`,
-        code: 1090,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1090,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'hash-const-does-not-exist'
     }),
     invalidHashIfValue: () => ({
         message: `#if conditionals can only be 'true', 'false', or other #const names`,
-        code: 1091,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1091,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-hash-if-value'
     }),
+    /**
+     * 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) => ({
-        message: `#error ${message}`,
-        code: 1092,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `#error ${message} `,
+        legacyCode: 1092,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'hash-error'
     }),
-    expectedEqualAfterConstName: () => ({
+    __unused43: () => ({
         message: `Expected '=' after #const`,
-        code: 1093,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1093,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-equal-after-hash-const'
     }),
-    expectedHashEndIfToCloseHashIf: (startingLine) => ({
-        message: `Expected '#end if' to close '#if' conditional compilation statement starting on line ${startingLine}`,
-        code: 1094,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    __unused17: (startingLine) => ({
+        message: `Expected '#end if' to close '#if' conditional compilation statement starting on line ${startingLine} `,
+        legacyCode: 1094,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-terminator-on-hash-if'
     }),
-    constNameCannotBeReservedWord: () => ({
+    __unused35: () => ({
         message: `#const name cannot be a reserved word`,
-        code: 1095,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1095,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'const-reservered-word'
     }),
-    expectedIdentifier: () => ({
+    __unused22: () => ({
         message: `Expected identifier`,
-        code: 1096,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1096,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-identifier'
     }),
     expectedAttributeNameAfterAtSymbol: () => ({
         message: `Expected xml attribute name after '@'`,
-        code: 1097,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1097,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-attribute-name'
     }),
     childFieldTypeNotAssignableToBaseProperty: (childTypeName, baseTypeName, fieldName, childFieldType, parentFieldType) => ({
-        message: `Field '${fieldName}' in class '${childTypeName}' is not assignable to the same field in base class '${baseTypeName}'. Type '${childFieldType}' is not assignable to type '${parentFieldType}'.`,
-        code: 1098,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Field '${fieldName}' in class '${childTypeName}' is not assignable to the same field in base class '${baseTypeName}'.Type '${childFieldType}' is not assignable to type '${parentFieldType}'.`,
+        legacyCode: 1098,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'field-inheritance-mismatch'
     }),
-    classChildMemberDifferentMemberTypeThanAncestor: (memberType, parentMemberType, parentClassName) => ({
+    __unused36: (memberType, parentMemberType, parentClassName) => ({
         message: `Class member is a ${memberType} here but a ${parentMemberType} in ancestor class '${parentClassName}'`,
-        code: 1099,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1099,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'child-field-type-different'
     }),
     classConstructorMissingSuperCall: () => ({
         message: `Missing "super()" call in class constructor method.`,
-        code: 1100,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1100,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-super-call'
     }),
     classConstructorIllegalUseOfMBeforeSuperCall: () => ({
         message: `Illegal use of "m" before calling "super()"`,
-        code: 1101,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1101,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-super-before-statement'
     }),
     classFieldCannotBeOverridden: () => ({
         message: `Class field cannot be overridden`,
-        code: 1102,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1102,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-field-override'
     }),
     unusedAnnotation: () => ({
         message: `This annotation is not attached to any statement`,
-        code: 1103,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1103,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-annotation'
     }),
     localVarShadowedByScopedFunction: () => ({
-        message: `Declaring a local variable with same name as scoped function can result in unexpected behavior`,
-        code: 1104,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Declaring a local variable with same name as scoped function or class can result in unexpected behavior`,
+        legacyCode: 1104,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'var-shadows-function'
     }),
     scopeFunctionShadowedByBuiltInFunction: () => ({
-        message: `Scope function will not be accessible because it has the same name as a built-in function`,
-        code: 1105,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Scope function will not be accessible because it has the same name as a built -in function`,
+        legacyCode: 1105,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'native-function-collision'
     }),
-    localVarSameNameAsClass: (className) => ({
+    __unused38: (className) => ({
         message: `Local variable has same name as class '${className}'`,
-        code: 1106,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1106,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'local-var-same-name-as-class'
     }),
-    unnecessaryCodebehindScriptImport: () => ({
+    __unused45: () => ({
         message: `This import is unnecessary because compiler option 'autoImportComponentScript' is enabled`,
-        code: 1107,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Warning
+        legacyCode: 1107,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Warning,
+        code: 'unnecessary-import'
     }),
-    expectedOpenParenToFollowCallfuncIdentifier: () => ({
+    __unused37: () => ({
         message: `Expected '(' to follow callfunc identifier`,
-        code: 1108,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1108,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-left-paren-after-callfunc'
     }),
     expectedToken: (...tokenKinds) => ({
         message: `Expected token '${tokenKinds.join(`' or '`)}'`,
-        code: 1109,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1109,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-token'
     }),
-    __unused8: (paramName) => ({
+    __unused10: (paramName) => ({
         message: `Parameter '${paramName}' may not have the same name as namespace`,
-        code: 1110,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1110,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'parameter-same-name-as-namespace'
     }),
-    __unused9: (variableName) => ({
+    __unused11: (variableName) => ({
         message: `Variable '${variableName}' may not have the same name as namespace`,
-        code: 1111,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1111,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'variable-same-name-as-namespace'
     }),
-    unterminatedTemplateStringAtEndOfFile: () => ({
-        message: `Unterminated template string at end of file`,
-        code: 1113,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    unterminatedTemplateString: () => ({
+        message: `Unterminated template string`,
+        legacyCode: 1113,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unterminated-template-string'
     }),
     unterminatedTemplateExpression: () => ({
         message: `Unterminated template string expression. '\${' must be followed by expression, then '}'`,
-        code: 1114,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1114,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unterminated-template-string-expression'
     }),
     duplicateComponentName: (componentName) => ({
         message: `There are multiple components with the name '${componentName}'`,
-        code: 1115,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1115,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'duplicate-component-name'
     }),
     __unused6: (className) => ({
         message: `Function has same name as class '${className}'`,
-        code: 1116,
+        legacyCode: 1116,
         severity: vscode_languageserver_1.DiagnosticSeverity.Error
     }),
     expectedExceptionVarToFollowCatch: () => ({
         message: `Expected exception variable after 'catch' keyword`,
-        code: 1117,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1117,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-exception-variable'
     }),
     missingExceptionExpressionAfterThrowKeyword: () => ({
         message: `Missing exception expression after 'throw' keyword`,
-        code: 1118,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1118,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-throw-expression'
     }),
-    missingLeftSquareBracketAfterDimIdentifier: () => ({
+    __unused42: () => ({
         message: `Missing left square bracket after 'dim' identifier`,
-        code: 1119,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1119,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-left-brace-after-dim'
     }),
-    missingRightSquareBracketAfterDimIdentifier: () => ({
+    __unused39: () => ({
         message: `Missing right square bracket after 'dim' identifier`,
-        code: 1120,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1120,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'missing-right-brace-after-dim'
     }),
     missingExpressionsInDimStatement: () => ({
         message: `Missing expression(s) in 'dim' statement`,
-        code: 1121,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1121,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-dim-expression'
     }),
     mismatchedOverriddenMemberVisibility: (childClassName, memberName, childAccessModifier, ancestorAccessModifier, ancestorClassName) => ({
         message: `Access modifier mismatch: '${memberName}' is ${childAccessModifier} in type '${childClassName}' but is ${ancestorAccessModifier} in base type '${ancestorClassName}'.`,
-        code: 1122,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1122,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'access-modifier-mismatch'
     }),
     __unused3: (typeName) => ({
         message: `Cannot find type with name '${typeName}'`,
-        code: 1123,
+        legacyCode: 1123,
         severity: vscode_languageserver_1.DiagnosticSeverity.Error
     }),
     enumValueMustBeType: (expectedType) => ({
         message: `Enum value must be type '${expectedType}'`,
-        code: 1124,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1124,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'enum-type-mismatch'
     }),
     enumValueIsRequired: (expectedType) => ({
         message: `Value is required for ${expectedType} enum`,
-        code: 1125,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1125,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'expected-enum-value'
     }),
-    unknownEnumValue: (name, enumName) => ({
+    __unused40: (name, enumName) => ({
         message: `Property '${name}' does not exist on enum '${enumName}'`,
-        code: 1126,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1126,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unknown-enum-value'
     }),
     __unused7: (scopeName, enumName) => ({
         message: `Scope '${scopeName}' already contains an enum with name '${enumName}'`,
-        code: 1127,
+        legacyCode: 1127,
         severity: vscode_languageserver_1.DiagnosticSeverity.Error
     }),
     unknownRoSGNode: (nodeName) => ({
         message: `Unknown roSGNode '${nodeName}'`,
-        code: 1128,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1128,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unknown-rosgnode'
     }),
     unknownBrightScriptComponent: (componentName) => ({
         message: `Unknown BrightScript component '${componentName}'`,
-        code: 1129,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1129,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unknown-brightscript-component'
     }),
     mismatchCreateObjectArgumentCount: (componentName, allowedArgCounts, actualCount) => {
         const argCountArray = (allowedArgCounts || [1]).sort().filter((value, index, self) => self.indexOf(value) === index);
         return {
             message: `For ${componentName}, expected ${argCountArray.map(c => c.toString()).join(' or ')} total arguments, but got ${actualCount}.`,
-            code: 1130,
-            severity: vscode_languageserver_1.DiagnosticSeverity.Error
+            legacyCode: 1130,
+            severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+            code: 'incorrect-createobject-argument-count'
         };
     },
-    deprecatedBrightScriptComponent: (componentName, deprecatedDescription) => ({
-        message: `${componentName} has been deprecated${deprecatedDescription ? ': ' + deprecatedDescription : ''}`,
-        code: 1131,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+    __unused41: (componentName, deprecatedDescription) => ({
+        message: `${componentName} has been deprecated${deprecatedDescription ? ': ' + deprecatedDescription : ''} `,
+        legacyCode: 1131,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'deprecated-brightscript-component'
     }),
     circularReferenceDetected: (items, scopeName) => ({
-        message: `Circular reference detected between ${Array.isArray(items) ? items.join(' -> ') : ''} in scope '${scopeName}'`,
-        code: 1132,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Circular inheritance detected between ${Array.isArray(items) ? items.join(' -> ') : ''} in scope '${scopeName}'`,
+        legacyCode: 1132,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'circular-inheritance'
     }),
     unexpectedStatementOutsideFunction: () => ({
         message: `Unexpected statement found outside of function body`,
-        code: 1133,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1133,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-statement'
     }),
     detectedTooDeepFileSource: (numberOfParentDirectories) => ({
-        message: `Expected directory depth no larger than 7, but found ${numberOfParentDirectories}`,
-        code: 1134,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `Expected directory depth no larger than 7, but found ${numberOfParentDirectories} `,
+        legacyCode: 1134,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'directory-depth'
     }),
     illegalContinueStatement: () => ({
         message: `Continue statement must be contained within a loop statement`,
-        code: 1135,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1135,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-continue'
     }),
     keywordMustBeDeclaredAtNamespaceLevel: (keyword) => ({
         message: `${keyword} must be declared at the root level or within a namespace`,
-        code: 1136,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1136,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-declaration-location'
     }),
     itemCannotBeUsedAsVariable: (itemType) => ({
         message: `${itemType} cannot be used as a variable`,
-        code: 1137,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1137,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'type-not-variable'
     }),
     callfuncHasToManyArgs: (numberOfArgs) => ({
-        message: `You can not have more than 5 arguments in a callFunc. ${numberOfArgs} found.`,
-        code: 1138,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        message: `You can not have more than 5 arguments in a callFunc.${numberOfArgs} found.`,
+        legacyCode: 1138,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'exceeds-max-callfunc-arg-count'
     }),
     noOptionalChainingInLeftHandSideOfAssignment: () => ({
         message: `Optional chaining may not be used in the left-hand side of an assignment`,
-        code: 1139,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1139,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'unexpected-optional-chain'
     }),
     /**
      *
@@ -737,90 +935,110 @@ exports.DiagnosticMessages = {
      * @param typeDescriptor defaults to 'type' ... could also be 'namespace', etc.
      */
     cannotFindFunction: (name, fullName, typeName, typeDescriptor = 'type') => ({
-        message: `Cannot find function '${name}'${typeName ? ` for ${typeDescriptor} '${typeName}'` : ''}`,
-        code: 1140,
+        message: `Cannot find function '${name}'${typeName ? ` for ${typeDescriptor} '${typeName}'` : ''} `,
+        legacyCode: 1140,
         data: {
             name: name,
             fullName: fullName !== null && fullName !== void 0 ? fullName : name,
             typeName: typeName ? typeName : undefined
         },
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'cannot-find-function'
     }),
     argumentTypeMismatch: (actualTypeString, expectedTypeString, data) => ({
-        message: `Argument of type '${actualTypeString}' is not compatible with parameter of type '${expectedTypeString}'${typeCompatibilityMessage(actualTypeString, expectedTypeString, data)}`,
+        message: `Argument of type '${actualTypeString}' is not compatible with parameter of type '${expectedTypeString}'${typeCompatibilityMessage(actualTypeString, expectedTypeString, data)} `,
         data: data,
-        code: 1141,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1141,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'argument-type-mismatch'
     }),
     returnTypeMismatch: (actualTypeString, expectedTypeString, data) => ({
-        message: `Type '${actualTypeString}' is not compatible with declared return type '${expectedTypeString}'${typeCompatibilityMessage(actualTypeString, expectedTypeString, data)}'`,
+        message: `Type '${actualTypeString}' is not compatible with declared return type '${expectedTypeString}'${typeCompatibilityMessage(actualTypeString, expectedTypeString, data)} '`,
         data: data,
-        code: 1142,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1142,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'return-type-mismatch'
     }),
     assignmentTypeMismatch: (actualTypeString, expectedTypeString, data) => ({
         message: `Type '${actualTypeString}' is not compatible with type '${expectedTypeString}'${typeCompatibilityMessage(actualTypeString, expectedTypeString, data)}`,
         data: data,
-        code: 1143,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1143,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'assignment-type-mismatch'
     }),
     operatorTypeMismatch: (operatorString, firstType, secondType = '') => ({
         message: `Operator '${operatorString}' cannot be applied to type${secondType ? 's' : ''} '${firstType}'${secondType ? ` and '${secondType}'` : ''}`,
-        code: 1144,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1144,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'operator-type-mismatch'
     }),
     incompatibleSymbolDefinition: (symbol, scopeName) => ({
         message: `'${symbol}' is incompatible across these scopes: ${scopeName}`,
-        code: 1145,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
-    }),
-    memberAccessibilityMismatch: (memberName, accessModifierFlag, definingClassName) => ({
-        message: `Member '${memberName}' is ${accessModifierNameFromFlag(accessModifierFlag)}${accessModifierAdditionalInfo(accessModifierFlag, definingClassName)}`,
-        code: 1146,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
-    }),
-    typecastStatementMustBeDeclaredAtStart: () => ({
-        message: `'typecast' statement must be declared at the top of the file or beginning of function or namespace`,
-        code: 1147,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1145,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'incompatible-definition'
     }),
+    memberAccessibilityMismatch: (memberName, accessModifierFlag, definingClassName) => {
+        let accessModName = TokenKind_1.TokenKind.Public;
+        // eslint-disable-next-line no-bitwise
+        if (accessModifierFlag & 8 /* SymbolTypeFlag.private */) {
+            accessModName = TokenKind_1.TokenKind.Private;
+            // eslint-disable-next-line no-bitwise
+        }
+        else if (accessModifierFlag & 16 /* SymbolTypeFlag.protected */) {
+            accessModName = TokenKind_1.TokenKind.Protected;
+        }
+        accessModName = accessModName.toLowerCase();
+        let accessAdditionalInfo = '';
+        // eslint-disable-next-line no-bitwise
+        if (accessModifierFlag & 8 /* SymbolTypeFlag.private */) {
+            accessAdditionalInfo = ` and only accessible from within class '${definingClassName}'`;
+            // eslint-disable-next-line no-bitwise
+        }
+        else if (accessModifierFlag & 16 /* SymbolTypeFlag.protected */) {
+            accessAdditionalInfo = ` and only accessible from within class '${definingClassName}' and its subclasses`;
+        }
+        return {
+            message: `Member '${memberName}' is ${accessModName}${accessAdditionalInfo}`,
+            legacyCode: 1146,
+            severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+            code: 'member-access-violation'
+        };
+    },
     invalidTypecastStatementApplication: (foundApplication) => ({
         message: `'typecast' statement can only be applied to 'm', but was applied to '${foundApplication}'`,
-        code: 1148,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1148,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-typecast-target'
     }),
     itemCannotBeUsedAsType: (typeText) => ({
         message: `'${typeText}' cannot be used as a type`,
-        code: 1149,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
-    }),
-    expectedNewlineInConditionalCompile: () => ({
-        message: `Expected newline in conditional compilation statement`,
-        code: 1151,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
-    }),
-    expectedTerminatorOnConditionalCompileBlock: () => ({
-        message: `Expected '#end if', '#else if', or '#else' to terminate conditional compilation block`,
-        code: 1152,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1149,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'invalid-type-reference'
     }),
     unsafeUnmatchedTerminatorInConditionalCompileBlock: (terminator) => ({
         message: `Unsafe unmatched terminator '${terminator}' in conditional compilation block`,
-        code: 1153,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        legacyCode: 1150,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'inconsistent-conditional-compile-nesting'
+    }),
+    returnTypeCoercionMismatch: (returnType = 'string') => ({
+        message: `Function has no return statement and will return 'invalid': '${returnType}' cannot be coerced into 'invalid'`,
+        legacyCode: 1151,
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'return-type-coercion-mismatch'
     }),
-    cannotFindTypeInCommentDoc: (name) => ({
-        message: `Cannot find type '${name}' in doc comment`,
-        code: 1154,
+    cannotFindCallFuncFunction: (name, fullName, typeName) => ({
+        message: `Cannot find callfunc function '${name}' for type '${typeName}'`,
         data: {
-            name: name
+            name: name,
+            fullName: fullName,
+            typeName: typeName,
+            isCallfunc: true
         },
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
-    }),
-    expectedReturnStatement: () => ({
-        message: `Expected return statement in function`,
-        code: 1155,
-        severity: vscode_languageserver_1.DiagnosticSeverity.Error
+        severity: vscode_languageserver_1.DiagnosticSeverity.Error,
+        code: 'cannot-find-callfunc'
     })
 };
 exports.defaultMaximumTruncationLength = 160;
@@ -851,33 +1069,32 @@ function typeCompatibilityMessage(actualTypeString, expectedTypeString, data) {
     return message;
 }
 exports.typeCompatibilityMessage = typeCompatibilityMessage;
-function accessModifierNameFromFlag(accessModifierFlag) {
-    let result = TokenKind_1.TokenKind.Public;
-    // eslint-disable-next-line no-bitwise
-    if (accessModifierFlag & 8 /* SymbolTypeFlag.private */) {
-        result = TokenKind_1.TokenKind.Private;
-        // eslint-disable-next-line no-bitwise
+function getPossibilitiesString(possibilities) {
+    if (!Array.isArray(possibilities)) {
+        return `'${possibilities}'`;
     }
-    else if (accessModifierFlag & 16 /* SymbolTypeFlag.protected */) {
-        result = TokenKind_1.TokenKind.Protected;
+    if (possibilities.length === 1) {
+        return `'${possibilities}'`;
     }
-    return result.toLowerCase();
-}
-function accessModifierAdditionalInfo(accessModifierFlag, className) {
-    // eslint-disable-next-line no-bitwise
-    if (accessModifierFlag & 8 /* SymbolTypeFlag.private */) {
-        return ` and only accessible from within class '${className}'`;
-        // eslint-disable-next-line no-bitwise
-    }
-    else if (accessModifierFlag & 16 /* SymbolTypeFlag.protected */) {
-        return ` and only accessible from within class '${className}' and its subclasses`;
+    let result = '';
+    for (let i = 0; i < possibilities.length; i++) {
+        result += `'${possibilities[i]}'`;
+        if (i < possibilities.length - 2) {
+            result += ', ';
+        }
+        else if (i < possibilities.length - 1) {
+            result += ' or ';
+        }
     }
-    return TokenKind_1.TokenKind.Public;
+    return result;
 }
 exports.DiagnosticCodeMap = {};
+exports.DiagnosticLegacyCodeMap = {};
 exports.diagnosticCodes = [];
 for (let key in exports.DiagnosticMessages) {
     exports.diagnosticCodes.push(exports.DiagnosticMessages[key]().code);
+    exports.diagnosticCodes.push(exports.DiagnosticMessages[key]().legacyCode);
     exports.DiagnosticCodeMap[key] = exports.DiagnosticMessages[key]().code;
+    exports.DiagnosticLegacyCodeMap[key] = exports.DiagnosticMessages[key]().legacyCode;
 }
 //# sourceMappingURL=DiagnosticMessages.js.map