brighterscript 0.42.0 → 0.45.0

package/dist/files/BrsFile.spec.js

@@ -12,7 +12,8 @@ const IntegerType_1 = require("../types/IntegerType");
 const StringType_1 = require("../types/StringType");
 const BrsFile_1 = require("./BrsFile");
 const source_map_1 = require("source-map");
-const lexer_1 = require("../lexer");
+const Lexer_1 = require("../lexer/Lexer");
+const TokenKind_1 = require("../lexer/TokenKind");
 const DiagnosticMessages_1 = require("../DiagnosticMessages");
 const util_1 = require("../util");
 const PluginInterface_1 = require("../PluginInterface");
@@ -36,24 +37,22 @@ describe('BrsFile', () => {
         program.dispose();
     });
     it('supports the third parameter in CreateObject', () => {
-        var _a;
-        program.addOrReplaceFile('source/main.brs', `
+        program.setFile('source/main.brs', `
             sub main()
                 regexp = CreateObject("roRegex", "[a-z]+", "i")
             end sub
         `);
         program.validate();
-        (0, chai_1.expect)((_a = program.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
+        (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
     });
     it('supports the 6 params in CreateObject for roRegion', () => {
-        var _a;
-        program.addOrReplaceFile('source/main.brs', `
+        program.setFile('source/main.brs', `
             sub createRegion(bitmap as object)
                 region = CreateObject("roRegion", bitmap, 20, 40, 100, 200)
             end sub
         `);
         program.validate();
-        (0, chai_1.expect)((_a = program.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
+        (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
     });
     it('sets needsTranspiled to true for .bs files', () => {
         //BrightScript
@@ -68,8 +67,7 @@ describe('BrsFile', () => {
                 range: undefined
             }];
         file.addDiagnostics(expected);
-        const actual = file.getDiagnostics();
-        (0, chai_1.expect)(actual).deep.equal(expected);
+        (0, testHelpers_spec_1.expectDiagnostics)(file, expected);
     });
     describe('getPartialVariableName', () => {
         let entry = {
@@ -77,7 +75,7 @@ describe('BrsFile', () => {
             dest: `source/lib.brs`
         };
         it('creates proper tokens', () => {
-            file = program.addOrReplaceFile(entry, `call(ModuleA.ModuleB.ModuleC.`);
+            file = program.setFile(entry, `call(ModuleA.ModuleB.ModuleC.`);
             (0, chai_1.expect)(file['getPartialVariableName'](file.parser.tokens[7])).to.equal('ModuleA.ModuleB.ModuleC.');
             (0, chai_1.expect)(file['getPartialVariableName'](file.parser.tokens[6])).to.equal('ModuleA.ModuleB.ModuleC');
             (0, chai_1.expect)(file['getPartialVariableName'](file.parser.tokens[5])).to.equal('ModuleA.ModuleB.');
@@ -89,13 +87,13 @@ describe('BrsFile', () => {
     describe('getScopesForFile', () => {
         it('finds the scope for the file', () => {
             var _a;
-            let file = program.addOrReplaceFile('source/main.brs', ``);
+            let file = program.setFile('source/main.brs', ``);
             (0, chai_1.expect)((_a = program.getScopesForFile(file)[0]) === null || _a === void 0 ? void 0 : _a.name).to.equal('source');
         });
     });
     describe('getCompletions', () => {
         it('does not crash for callfunc on a function call', () => {
-            const file = program.addOrReplaceFile('source/main.brs', `
+            const file = program.setFile('source/main.brs', `
                 sub main()
                     getManager()@.
                 end sub
@@ -105,7 +103,7 @@ describe('BrsFile', () => {
             }).not.to.throw;
         });
         it('suggests pkg paths in strings that match that criteria', () => {
-            program.addOrReplaceFile('source/main.brs', `
+            program.setFile('source/main.brs', `
                 sub main()
                     print "pkg:"
                 end sub
@@ -117,7 +115,7 @@ describe('BrsFile', () => {
             ]);
         });
         it('suggests libpkg paths in strings that match that criteria', () => {
-            program.addOrReplaceFile('source/main.brs', `
+            program.setFile('source/main.brs', `
                 sub main()
                     print "libpkg:"
                 end sub
@@ -129,7 +127,7 @@ describe('BrsFile', () => {
             ]);
         });
         it('suggests pkg paths in template strings', () => {
-            program.addOrReplaceFile('source/main.brs', `
+            program.setFile('source/main.brs', `
                 sub main()
                     print \`pkg:\`
                 end sub
@@ -142,7 +140,7 @@ describe('BrsFile', () => {
         });
         it('waits for the file to be processed before collecting completions', () => {
             //eslint-disable-next-line @typescript-eslint/no-floating-promises
-            program.addOrReplaceFile('source/main.brs', `
+            program.setFile('source/main.brs', `
                 sub Main()
                     print "hello"
                     Say
@@ -156,9 +154,79 @@ describe('BrsFile', () => {
             (0, chai_1.expect)(names).to.includes('Main');
             (0, chai_1.expect)(names).to.includes('SayHello');
         });
+        it('includes every type of item at base level', () => {
+            program.setFile('source/main.bs', `
+                sub main()
+                    print
+                end sub
+                sub speak()
+                end sub
+                namespace stuff
+                end namespace
+                class Person
+                end class
+                enum Direction
+                end enum
+            `);
+            (0, testHelpers_spec_1.expectCompletionsIncludes)(program.getCompletions('source/main.bs', util_1.default.createPosition(2, 26)), [{
+                    label: 'main',
+                    kind: vscode_languageserver_1.CompletionItemKind.Function
+                }, {
+                    label: 'speak',
+                    kind: vscode_languageserver_1.CompletionItemKind.Function
+                }, {
+                    label: 'stuff',
+                    kind: vscode_languageserver_1.CompletionItemKind.Module
+                }, {
+                    label: 'Person',
+                    kind: vscode_languageserver_1.CompletionItemKind.Class
+                }, {
+                    label: 'Direction',
+                    kind: vscode_languageserver_1.CompletionItemKind.Enum
+                }]);
+        });
+        describe('namespaces', () => {
+            it('gets full namespace completions at any point through the leading identifier', () => {
+                program.setFile('source/main.bs', `
+                    sub main()
+                        foo.bar
+                    end sub
+
+                    namespace foo.bar
+                    end namespace
+
+                    class Person
+                    end class
+                `);
+                const result = program.getCompletions(`${rootDir}/source/main.bs`, vscode_languageserver_1.Position.create(2, 24)).map(x => x.label);
+                (0, chai_1.expect)(result).includes('main');
+                (0, chai_1.expect)(result).includes('foo');
+                (0, chai_1.expect)(result).includes('Person');
+            });
+            it('gets namespace completions', () => {
+                program.setFile('source/main.bs', `
+                    namespace foo.bar
+                        function sayHello()
+                        end function
+                    end namespace
+
+                    sub Main()
+                        print "hello"
+                        foo.ba
+                        foo.bar.
+                    end sub
+                `);
+                let result = program.getCompletions(`${rootDir}/source/main.bs`, vscode_languageserver_1.Position.create(8, 30));
+                let names = result.map(x => x.label);
+                (0, chai_1.expect)(names).to.includes('bar');
+                result = program.getCompletions(`${rootDir}/source/main.bs`, vscode_languageserver_1.Position.create(9, 32));
+                names = result.map(x => x.label);
+                (0, chai_1.expect)(names).to.includes('sayHello');
+            });
+        });
         it('always includes `m`', () => {
             //eslint-disable-next-line @typescript-eslint/no-floating-promises
-            program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
 
                 end sub
@@ -169,19 +237,19 @@ describe('BrsFile', () => {
         });
         it('does not fail for missing previousToken', () => {
             //add a single character to the file, and get completions after it
-            program.addOrReplaceFile('source/main.brs', `i`);
+            program.setFile('source/main.brs', `i`);
             (0, chai_1.expect)(() => {
                 program.getCompletions(`${rootDir}/source/main.brs`, vscode_languageserver_1.Position.create(0, 1)).map(x => x.label);
             }).not.to.throw;
         });
         it('includes all keywords`', () => {
             //eslint-disable-next-line @typescript-eslint/no-floating-promises
-            program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
 
                 end sub
             `);
-            let keywords = Object.keys(lexer_1.Keywords).filter(x => !x.includes(' '));
+            let keywords = Object.keys(TokenKind_1.Keywords).filter(x => !x.includes(' '));
             //inside the function
             let result = program.getCompletions(`${rootDir}/source/main.brs`, vscode_languageserver_1.Position.create(2, 23));
             let names = result.map(x => x.label);
@@ -197,7 +265,7 @@ describe('BrsFile', () => {
         });
         it('does not provide completions within a comment', () => {
             //eslint-disable-next-line @typescript-eslint/no-floating-promises
-            program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
                     'some comment
                 end sub
@@ -208,7 +276,7 @@ describe('BrsFile', () => {
         });
         it('does not provide duplicate entries for variables', () => {
             //eslint-disable-next-line @typescript-eslint/no-floating-promises
-            program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
                     name = "bob"
                     age = 12
@@ -223,7 +291,7 @@ describe('BrsFile', () => {
         });
         it('does not include `as` and `string` text options when used in function params', () => {
             //eslint-disable-next-line @typescript-eslint/no-floating-promises
-            program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main(name as string)
 
                 end sub
@@ -234,7 +302,7 @@ describe('BrsFile', () => {
         });
         it('does not provide intellisense results when inside a comment', () => {
             //eslint-disable-next-line @typescript-eslint/no-floating-promises
-            program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main(name as string)
                     'this is a comment
                 end sub
@@ -245,7 +313,7 @@ describe('BrsFile', () => {
         it('does provide intellisence for labels only after a goto keyword', () => {
             var _a;
             //eslint-disable-next-line @typescript-eslint/no-floating-promises
-            program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main(name as string)
                     something:
                     goto \nend sub
@@ -258,28 +326,26 @@ describe('BrsFile', () => {
     describe('comment flags', () => {
         describe('bs:disable-next-line', () => {
             it('disables critical diagnostic issues', () => {
-                var _a, _b;
-                program.addOrReplaceFile('source/main.brs', `
+                program.setFile('source/main.brs', `
                     sub main()
                         Dim requestData
                     end sub
                 `);
                 //should have an error
                 program.validate();
-                (0, chai_1.expect)((_a = program.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).to.exist;
-                program.addOrReplaceFile('source/main.brs', `
+                (0, testHelpers_spec_1.expectHasDiagnostics)(program);
+                program.setFile('source/main.brs', `
                     sub main()
                         'bs:disable-next-line
                         Dim requestData
                     end sub
                 `);
-                //should have an error
+                //should not have an error
                 program.validate();
-                (0, chai_1.expect)((_b = program.getDiagnostics()[0]) === null || _b === void 0 ? void 0 : _b.message).not.to.exist;
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
             });
             it('works with leading whitespace', () => {
-                var _a;
-                program.addOrReplaceFile('source/main.brs', `
+                program.setFile('source/main.brs', `
                     sub main()
                         ' bs:disable-next-line
                         =asdf=sadf=
@@ -287,11 +353,10 @@ describe('BrsFile', () => {
                 `);
                 //should have an error
                 program.validate();
-                (0, chai_1.expect)((_a = program.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
             });
             it('works for all', () => {
-                var _a;
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub Main()
                         'bs:disable-next-line
                         name = "bob
@@ -305,11 +370,10 @@ describe('BrsFile', () => {
                 });
                 program.validate();
                 //the "unterminated string" error should be filtered out
-                (0, chai_1.expect)((_a = program.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
             });
             it('works for specific codes', () => {
-                var _a;
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub Main()
                         'bs:disable-next-line: 1083, 1001
                         name = "bob
@@ -322,22 +386,21 @@ describe('BrsFile', () => {
                     affectedRange: util_1.default.createRange(3, 0, 3, Number.MAX_SAFE_INTEGER)
                 });
                 //the "unterminated string" error should be filtered out
-                (0, chai_1.expect)((_a = program.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
             });
             it('recognizes non-numeric codes', () => {
-                var _a;
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub Main()
                         'bs:disable-next-line: LINT9999
                         name = "bob
                     end sub
                 `);
                 (0, chai_1.expect)(file.commentFlags[0]).to.exist;
-                (0, chai_1.expect)((_a = program.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).to.exist;
+                (0, testHelpers_spec_1.expectHasDiagnostics)(program);
             });
             it('supports disabling non-numeric error codes', () => {
                 const program = new Program_1.Program({});
-                const file = program.addOrReplaceFile('source/main.brs', `
+                const file = program.setFile('source/main.brs', `
                     sub main()
                         something = true 'bs:disable-line: LINT1005
                     end sub
@@ -348,27 +411,22 @@ describe('BrsFile', () => {
                         message: 'Something is not right',
                         range: util_1.default.createRange(2, 16, 2, 26)
                     }]);
-                (0, chai_1.expect)(program.getScopesForFile(file)[0].getDiagnostics()).to.be.empty;
+                const scope = program.getScopesForFile(file)[0];
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(scope);
             });
             it('adds diagnostics for unknown numeric diagnostic codes', () => {
-                program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         print "hi" 'bs:disable-line: 123456 999999   aaaab
                     end sub
                 `);
                 program.validate();
-                (0, chai_1.expect)(program.getDiagnostics()).to.be.lengthOf(2);
-                (0, chai_1.expect)(program.getDiagnostics()[0]).to.deep.include({
-                    range: vscode_languageserver_1.Range.create(2, 53, 2, 59)
-                });
-                (0, chai_1.expect)(program.getDiagnostics()[1]).to.deep.include({
-                    range: vscode_languageserver_1.Range.create(2, 60, 2, 66)
-                });
+                (0, testHelpers_spec_1.expectDiagnostics)(program, [Object.assign(Object.assign({}, DiagnosticMessages_1.DiagnosticMessages.unknownDiagnosticCode(123456)), { range: vscode_languageserver_1.Range.create(2, 53, 2, 59) }), Object.assign(Object.assign({}, DiagnosticMessages_1.DiagnosticMessages.unknownDiagnosticCode(999999)), { range: vscode_languageserver_1.Range.create(2, 60, 2, 66) })]);
             });
         });
         describe('bs:disable-line', () => {
             it('works for all', () => {
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub Main()
                         z::;;%%%%%% 'bs:disable-line
                     end sub
@@ -381,10 +439,10 @@ describe('BrsFile', () => {
                 });
                 program.validate();
                 //the "unterminated string" error should be filtered out
-                (0, chai_1.expect)(program.getDiagnostics()).to.be.lengthOf(0);
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
             });
             it('works for specific codes', () => {
-                program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         'should not have any errors
                         DoSomething(1) 'bs:disable-line:1002
@@ -395,29 +453,28 @@ describe('BrsFile', () => {
                     end sub
                 `);
                 program.validate();
-                (0, chai_1.expect)(program.getDiagnostics()).to.be.lengthOf(1);
-                (0, chai_1.expect)(program.getDiagnostics()[0]).to.deep.include({
-                    range: vscode_languageserver_1.Range.create(5, 24, 5, 35)
-                });
+                (0, testHelpers_spec_1.expectDiagnostics)(program, [{
+                        range: vscode_languageserver_1.Range.create(5, 24, 5, 35)
+                    }]);
             });
             it('handles the erraneous `stop` keyword', () => {
                 //the current version of BRS causes parse errors after the `parse` keyword, showing error in comments
                 //the program should ignore all diagnostics found in brs:* comment lines EXCEPT
                 //for the diagnostics about using unknown error codes
-                program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         stop 'bs:disable-line
                         print "need a valid line to fix stop error"
                     end sub
                 `);
                 program.validate();
-                (0, chai_1.expect)(program.getDiagnostics()).to.be.lengthOf(0);
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
             });
         });
     });
     describe('parse', () => {
         it('supports iife in assignment', () => {
-            program.addOrReplaceFile('source/main.brs', `
+            program.setFile('source/main.brs', `
                 sub main()
                     result = sub()
                     end sub()
@@ -429,7 +486,7 @@ describe('BrsFile', () => {
         });
         it('uses the proper parse mode based on file extension', () => {
             function testParseMode(destPath, expectedParseMode) {
-                const file = program.addOrReplaceFile(destPath, '');
+                const file = program.setFile(destPath, '');
                 (0, chai_1.expect)(file.parseMode).to.equal(expectedParseMode);
             }
             testParseMode('source/main.brs', Parser_1.ParseMode.BrightScript);
@@ -440,26 +497,26 @@ describe('BrsFile', () => {
             testParseMode('source/main.spec.bs', Parser_1.ParseMode.BrighterScript);
         });
         it('supports labels and goto statements', () => {
-            let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
                     'multiple goto statements on one line
                     goto myLabel : goto myLabel
                     myLabel:
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports empty print statements', () => {
-            let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub main()
                    print
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         describe('conditional compile', () => {
             it('works for upper case keywords', () => {
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         #CONST someFlag = true
                         #IF someFlag
@@ -471,10 +528,10 @@ describe('BrsFile', () => {
                         #ENDIF
                     end sub
                 `);
-                (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
             });
             it('supports single-word #elseif and #endif', () => {
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         #const someFlag = true
                         #if someFlag
@@ -484,10 +541,10 @@ describe('BrsFile', () => {
                         #endif
                     end sub
                 `);
-                (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
             });
             it('supports multi-word #else if and #end if', () => {
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         #const someFlag = true
                         #if someFlag
@@ -497,65 +554,75 @@ describe('BrsFile', () => {
                         #end if
                     end sub
                 `);
-                (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
             });
             it('does not choke on invalid code inside a false conditional compile', () => {
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         #if false
                             non-commented code here should not cause parse errors
                         #end if
                     end sub
                 `);
-                (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
             });
             it('detects syntax error in #if', () => {
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         #if true1
                             print "true"
                         #end if
                     end sub
                 `);
-                (0, chai_1.expect)(file.getDiagnostics()[0]).to.exist.and.deep.include(Object.assign({}, DiagnosticMessages_1.DiagnosticMessages.invalidHashConstValue));
+                (0, testHelpers_spec_1.expectDiagnostics)(file, [
+                    DiagnosticMessages_1.DiagnosticMessages.referencedConstDoesNotExist()
+                ]);
             });
             it('detects syntax error in #const', () => {
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         #if %
                             print "true"
                         #end if
                     end sub
                 `);
-                (0, chai_1.expect)(file.getDiagnostics()[0]).to.exist.and.deep.include(Object.assign({}, DiagnosticMessages_1.DiagnosticMessages.unexpectedCharacter('%')));
+                (0, testHelpers_spec_1.expectDiagnostics)(file, [
+                    DiagnosticMessages_1.DiagnosticMessages.unexpectedCharacter('%'),
+                    DiagnosticMessages_1.DiagnosticMessages.invalidHashIfValue()
+                ]);
             });
             it('detects #const name using reserved word', () => {
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         #const function = true
                     end sub
                 `);
-                (0, chai_1.expect)(file.getDiagnostics()[0]).to.exist.and.deep.include(Object.assign({}, DiagnosticMessages_1.DiagnosticMessages.constNameCannotBeReservedWord()));
+                (0, testHelpers_spec_1.expectDiagnostics)(file, [
+                    DiagnosticMessages_1.DiagnosticMessages.constNameCannotBeReservedWord(),
+                    DiagnosticMessages_1.DiagnosticMessages.unexpectedToken('#const')
+                ]);
             });
             it('detects syntax error in #const', () => {
-                let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+                let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                     sub main()
                         #const someConst = 123
                     end sub
                 `);
-                (0, chai_1.expect)(file.getDiagnostics()[0]).to.exist.and.deep.include(Object.assign({}, DiagnosticMessages_1.DiagnosticMessages.invalidHashConstValue()));
+                (0, testHelpers_spec_1.expectDiagnostics)(file, [
+                    DiagnosticMessages_1.DiagnosticMessages.invalidHashConstValue()
+                ]);
             });
         });
         it('supports stop statement', () => {
-            let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub main()
                    stop
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports single-line if statements', () => {
-            let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub main()
                     if 1 < 2: return true: end if
                     if 1 < 2: return true
@@ -565,16 +632,15 @@ describe('BrsFile', () => {
                     if true then : test = sub() : print "yes" : end sub : end if
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports line_num as global variable', () => {
-            var _a;
             file.parse(`
                 sub Main()
                     print LINE_NUM
                 end sub
             `);
-            (0, chai_1.expect)((_a = file.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports many keywords as object property names', () => {
             file.parse(`
@@ -640,7 +706,7 @@ describe('BrsFile', () => {
                     person.new = true
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('does not error on numeric literal type designators', () => {
             file.parse(`
@@ -654,7 +720,7 @@ describe('BrsFile', () => {
                     print 9876543210&
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('does not error when encountering sub with return type', () => {
             file.parse(`
@@ -662,7 +728,7 @@ describe('BrsFile', () => {
                     return
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('does not lose function scopes when mismatched end sub', () => {
             file.parse(`
@@ -697,7 +763,7 @@ describe('BrsFile', () => {
                     foo.bar = true and false or 3 > 4
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('does not error with boolean in RHS of set statement', () => {
             file.parse(`
@@ -710,7 +776,7 @@ describe('BrsFile', () => {
                     m.isTrue = m.isTrue = m.isTrue
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports variable names ending with type designators', () => {
             file.parse(`
@@ -722,7 +788,7 @@ describe('BrsFile', () => {
                   someHex& = 13
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports multiple spaces between two-word keywords', () => {
             file.parse(`
@@ -734,7 +800,7 @@ describe('BrsFile', () => {
                     end if
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('does not error with `stop` as object key', () => {
             file.parse(`
@@ -747,7 +813,7 @@ describe('BrsFile', () => {
                     return obj
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('does not error with `run` as object key', () => {
             file.parse(`
@@ -760,7 +826,7 @@ describe('BrsFile', () => {
                     return obj
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports assignment operators', () => {
             file.parse(`
@@ -777,7 +843,7 @@ describe('BrsFile', () => {
                     print x
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports `then` as object property', () => {
             file.parse(`
@@ -789,7 +855,7 @@ describe('BrsFile', () => {
                     promise.then()
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports function as parameter type', () => {
             file.parse(`
@@ -798,7 +864,7 @@ describe('BrsFile', () => {
                     end function
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports increment operator', () => {
             file.parse(`
@@ -807,8 +873,7 @@ describe('BrsFile', () => {
                     x++
                 end function
             `);
-            file.getDiagnostics();
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports decrement operator', () => {
             file.parse(`
@@ -817,8 +882,7 @@ describe('BrsFile', () => {
                     x--
                 end function
             `);
-            file.getDiagnostics();
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports writing numbers with decimal but no trailing digit', () => {
             file.parse(`
@@ -827,7 +891,7 @@ describe('BrsFile', () => {
                     print x
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports assignment operators against object properties', () => {
             file.parse(`
@@ -849,7 +913,7 @@ describe('BrsFile', () => {
                     print m.age
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         //skipped until `brs` supports this
         it('supports bitshift assignment operators', () => {
@@ -861,7 +925,7 @@ describe('BrsFile', () => {
                     print x
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         //skipped until `brs` supports this
         it('supports bitshift assignment operators on objects', () => {
@@ -873,7 +937,7 @@ describe('BrsFile', () => {
                         print m.x
                     end function
                 `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports leading and trailing periods for numeric literals', () => {
             file.parse(`
@@ -884,7 +948,7 @@ describe('BrsFile', () => {
                     print pointOne
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports bitshift assignment operators on object properties accessed by array syntax', () => {
             file.parse(`
@@ -895,7 +959,7 @@ describe('BrsFile', () => {
                         print m.x
                     end function
                 `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('supports weird period AA accessor', () => {
             file.parse(`
@@ -904,42 +968,46 @@ describe('BrsFile', () => {
                     print m.["_uuid"]
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('adds error for library statements NOT at top of file', () => {
-            let file = program.addOrReplaceFile('source/main.bs', `
+            program.setFile('source/file.brs', ``);
+            program.setFile('source/main.bs', `
                 sub main()
                 end sub
                 import "file.brs"
             `);
-            (0, chai_1.expect)(file.getDiagnostics().map(x => x.message)).to.eql([
-                DiagnosticMessages_1.DiagnosticMessages.importStatementMustBeDeclaredAtTopOfFile().message
+            program.validate();
+            (0, testHelpers_spec_1.expectDiagnostics)(program, [
+                DiagnosticMessages_1.DiagnosticMessages.importStatementMustBeDeclaredAtTopOfFile()
             ]);
         });
         it('supports library imports', () => {
-            file.parse(`
+            program.setFile('source/main.brs', `
                 Library "v30/bslCore.brs"
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
         });
         it('adds error for library statements NOT at top of file', () => {
-            let file = program.addOrReplaceFile('source/main.brs', `
+            program.setFile('source/main.brs', `
                 sub main()
                 end sub
                 Library "v30/bslCore.brs"
             `);
-            (0, chai_1.expect)(file.getDiagnostics().map(x => x.message)).to.eql([
-                DiagnosticMessages_1.DiagnosticMessages.libraryStatementMustBeDeclaredAtTopOfFile().message
+            program.validate();
+            (0, testHelpers_spec_1.expectDiagnostics)(program, [
+                DiagnosticMessages_1.DiagnosticMessages.libraryStatementMustBeDeclaredAtTopOfFile()
             ]);
         });
         it('adds error for library statements inside of function body', () => {
-            let file = program.addOrReplaceFile('source/main.brs', `
+            program.setFile('source/main.brs', `
                 sub main()
                     Library "v30/bslCore.brs"
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics().map(x => x.message)).to.eql([
-                DiagnosticMessages_1.DiagnosticMessages.libraryStatementMustBeDeclaredAtTopOfFile().message
+            program.validate();
+            (0, testHelpers_spec_1.expectDiagnostics)(program, [
+                DiagnosticMessages_1.DiagnosticMessages.libraryStatementMustBeDeclaredAtTopOfFile()
             ]);
         });
         it('supports colons as separators in associative array properties', () => {
@@ -948,10 +1016,10 @@ describe('BrsFile', () => {
                     obj = {x:0 : y: 1}
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         it('succeeds when finding variables with "sub" in them', () => {
-            let file = program.addOrReplaceFile('source/main.brs', `
+            let file = program.setFile('source/main.brs', `
                 function DoSomething()
                     return value.subType()
                 end function
@@ -1034,10 +1102,8 @@ describe('BrsFile', () => {
                 function DoSomething
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics().length).to.be.greaterThan(0);
-            (0, chai_1.expect)(file.getDiagnostics()[0]).to.deep.include({
-                file: file
-            });
+            (0, testHelpers_spec_1.expectHasDiagnostics)(file);
+            (0, chai_1.expect)(file.getDiagnostics()[0].file).to.equal(file);
             (0, chai_1.expect)(file.getDiagnostics()[0].range.start.line).to.equal(1);
         });
         it('supports using the `next` keyword in a for loop', () => {
@@ -1049,7 +1115,7 @@ describe('BrsFile', () => {
                     next
                 end sub
             `);
-            (0, chai_1.expect)(file.getDiagnostics()).to.be.empty;
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
         //test is not working yet, but will be enabled when brs supports this syntax
         it('supports assigning functions to objects', () => {
@@ -1062,7 +1128,7 @@ describe('BrsFile', () => {
                     end sub
                 end function
             `);
-            (0, chai_1.expect)(file.getDiagnostics().length).to.equal(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(file);
         });
     });
     describe('findCallables', () => {
@@ -1183,8 +1249,7 @@ describe('BrsFile', () => {
                 }]);
         });
         it('finds function calls nested inside statements', () => {
-            var _a;
-            program.addOrReplaceFile(`source/main.brs`, `
+            program.setFile(`source/main.brs`, `
                 sub main()
                     if true then
                         DoesNotExist(1, 2)
@@ -1192,7 +1257,9 @@ describe('BrsFile', () => {
                 end sub
             `);
             program.validate();
-            (0, chai_1.expect)((_a = program.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).to.equal(DiagnosticMessages_1.DiagnosticMessages.callToUnknownFunction('DoesNotExist', 'source').message);
+            (0, testHelpers_spec_1.expectDiagnostics)(program, [
+                DiagnosticMessages_1.DiagnosticMessages.callToUnknownFunction('DoesNotExist', 'source')
+            ]);
         });
         it('finds arguments with variable values', () => {
             let file = new BrsFile_1.BrsFile('absolute_path/file.brs', 'relative_path/file.brs', program);
@@ -1227,7 +1294,7 @@ describe('BrsFile', () => {
             (0, chai_1.expect)(file.callables.length).to.equal(0);
         });
         it('finds return type', () => {
-            let file = program.addOrReplaceFile('source/main.brs', `
+            let file = program.setFile('source/main.brs', `
                 function DoSomething() as string
                 end function
             `);
@@ -1321,7 +1388,7 @@ describe('BrsFile', () => {
             (0, chai_1.expect)(scope.variableDeclarations[0].name).to.equal('theLength');
         });
         it('finds value from global return', () => {
-            let file = program.addOrReplaceFile('source/main.brs', `
+            let file = program.setFile('source/main.brs', `
                 sub Main()
                    myName = GetName()
                 end sub
@@ -1366,7 +1433,7 @@ describe('BrsFile', () => {
     });
     describe('getHover', () => {
         it('works for param types', () => {
-            let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub DoSomething(name as string)
                     name = 1
                     sayMyName = function(name as string)
@@ -1384,7 +1451,7 @@ describe('BrsFile', () => {
         });
         //ignore this for now...it's not a huge deal
         it('does not match on keywords or data types', () => {
-            let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main(name as string)
                 end sub
                 sub as()
@@ -1396,7 +1463,7 @@ describe('BrsFile', () => {
             (0, chai_1.expect)(file.getHover(vscode_languageserver_1.Position.create(1, 36))).not.to.exist;
         });
         it('finds declared function', () => {
-            let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 function Main(count = 1)
                     firstName = "bob"
                     age = 21
@@ -1406,10 +1473,14 @@ describe('BrsFile', () => {
             let hover = file.getHover(vscode_languageserver_1.Position.create(1, 28));
             (0, chai_1.expect)(hover).to.exist;
             (0, chai_1.expect)(hover.range).to.eql(vscode_languageserver_1.Range.create(1, 25, 1, 29));
-            (0, chai_1.expect)(hover.contents).to.equal('function Main(count? as dynamic) as dynamic');
+            (0, chai_1.expect)(hover.contents).to.equal([
+                '```brightscript',
+                'function Main(count? as dynamic) as dynamic',
+                '```'
+            ].join('\n'));
         });
         it('finds variable function hover in same scope', () => {
-            let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
                     sayMyName = sub(name as string)
                     end sub
@@ -1419,10 +1490,39 @@ describe('BrsFile', () => {
             `);
             let hover = file.getHover(vscode_languageserver_1.Position.create(5, 24));
             (0, chai_1.expect)(hover.range).to.eql(vscode_languageserver_1.Range.create(5, 20, 5, 29));
-            (0, chai_1.expect)(hover.contents).to.equal('sub sayMyName(name as string) as void');
+            (0, chai_1.expect)(hover.contents).to.equal([
+                '```brightscript',
+                'sub sayMyName(name as string) as void',
+                '```'
+            ].join('\n'));
+        });
+        it('does not crash when hovering on built-in functions', async () => {
+            let file = program.setFile('source/main.brs', `
+                function doUcase(text)
+                    return ucase(text)
+                end function
+            `);
+            (0, chai_1.expect)((await program.getHover(file.pathAbsolute, vscode_languageserver_1.Position.create(2, 30))).contents).to.equal([
+                '```brightscript',
+                'function UCase(s as string) as string',
+                '```'
+            ].join('\n'));
+        });
+        it('does not crash when hovering on object method call', async () => {
+            let file = program.setFile('source/main.brs', `
+                function getInstr(url, text)
+                    return url.instr(text)
+                end function
+            `);
+            (0, chai_1.expect)((await program.getHover(file.pathAbsolute, vscode_languageserver_1.Position.create(2, 35))).contents).to.equal([
+                '```brightscript',
+                //TODO this really shouldn't be returning the global function, but it does...so make sure it doesn't crash right now.
+                'function Instr(start as integer, text as string, substring as string) as integer',
+                '```'
+            ].join('\n'));
         });
         it('finds function hover in file scope', () => {
-            let file = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let file = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
                     sayMyName()
                 end sub
@@ -1433,19 +1533,23 @@ describe('BrsFile', () => {
             `);
             let hover = file.getHover(vscode_languageserver_1.Position.create(2, 25));
             (0, chai_1.expect)(hover.range).to.eql(vscode_languageserver_1.Range.create(2, 20, 2, 29));
-            (0, chai_1.expect)(hover.contents).to.equal('sub sayMyName() as void');
+            (0, chai_1.expect)(hover.contents).to.equal([
+                '```brightscript',
+                'sub sayMyName() as void',
+                '```'
+            ].join('\n'));
         });
         it('finds function hover in scope', () => {
             let rootDir = process.cwd();
             program = new Program_1.Program({
                 rootDir: rootDir
             });
-            let mainFile = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let mainFile = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
                     sayMyName()
                 end sub
             `);
-            program.addOrReplaceFile({ src: `${rootDir}/source/lib.brs`, dest: 'source/lib.brs' }, `
+            program.setFile({ src: `${rootDir}/source/lib.brs`, dest: 'source/lib.brs' }, `
                 sub sayMyName(name as string)
 
                 end sub
@@ -1453,37 +1557,83 @@ describe('BrsFile', () => {
             let hover = mainFile.getHover(vscode_languageserver_1.Position.create(2, 25));
             (0, chai_1.expect)(hover).to.exist;
             (0, chai_1.expect)(hover.range).to.eql(vscode_languageserver_1.Range.create(2, 20, 2, 29));
-            (0, chai_1.expect)(hover.contents).to.equal('sub sayMyName(name as string) as void');
+            (0, chai_1.expect)(hover.contents).to.equal([
+                '```brightscript',
+                'sub sayMyName(name as string) as void',
+                '```'
+            ].join('\n'));
+        });
+        it('includes markdown comments in hover.', async () => {
+            let rootDir = process.cwd();
+            program = new Program_1.Program({
+                rootDir: rootDir
+            });
+            const file = program.setFile('source/lib.brs', `
+                '
+                ' The main function
+                '
+                sub main()
+                    log("hello")
+                end sub
+
+                '
+                ' Prints a message to the log.
+                ' Works with *markdown* **content**
+                '
+                sub log(message as string)
+                    print message
+                end sub
+            `);
+            //hover over log("hello")
+            (0, chai_1.expect)((await program.getHover(file.pathAbsolute, vscode_languageserver_1.Position.create(5, 22))).contents).to.equal([
+                '```brightscript',
+                'sub log(message as string) as void',
+                '```',
+                '***',
+                '',
+                ' Prints a message to the log.',
+                ' Works with *markdown* **content**',
+                ''
+            ].join('\n'));
+            //hover over sub ma|in()
+            (0, chai_1.expect)((await program.getHover(file.pathAbsolute, vscode_languageserver_1.Position.create(4, 22))).contents).to.equal((0, testHelpers_spec_1.trim) `
+                \`\`\`brightscript
+                sub main() as void
+                \`\`\`
+                ***
+
+                 The main function
+                `);
         });
         it('handles mixed case `then` partions of conditionals', () => {
-            let mainFile = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            let mainFile = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
                     if true then
                         print "works"
                     end if
                 end sub
             `);
-            (0, chai_1.expect)(mainFile.getDiagnostics()).to.be.lengthOf(0);
-            mainFile = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(mainFile);
+            mainFile = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
                     if true Then
                         print "works"
                     end if
                 end sub
             `);
-            (0, chai_1.expect)(mainFile.getDiagnostics()).to.be.lengthOf(0);
-            mainFile = program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(mainFile);
+            mainFile = program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
                 sub Main()
                     if true THEN
                         print "works"
                     end if
                 end sub
             `);
-            (0, chai_1.expect)(mainFile.getDiagnostics()).to.be.lengthOf(0);
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(mainFile);
         });
     });
     it('does not throw when encountering incomplete import statement', () => {
-        program.addOrReplaceFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
+        program.setFile({ src: `${rootDir}/source/main.brs`, dest: 'source/main.brs' }, `
             import
             sub main()
             end sub
@@ -1788,9 +1938,9 @@ describe('BrsFile', () => {
         });
         it('computes correct locations for sourcemap', async () => {
             let source = `function abc(name)\n    firstName = name\nend function`;
-            let tokens = lexer_1.Lexer.scan(source).tokens
+            let tokens = Lexer_1.Lexer.scan(source).tokens
                 //remove newlines and EOF
-                .filter(x => x.kind !== lexer_1.TokenKind.Eof && x.kind !== lexer_1.TokenKind.Newline);
+                .filter(x => x.kind !== TokenKind_1.TokenKind.Eof && x.kind !== TokenKind_1.TokenKind.Newline);
             program.options.sourceMap = true;
             let result = testTranspile(source, source, 'none');
             //load the source map
@@ -2006,7 +2156,7 @@ describe('BrsFile', () => {
             `);
         });
         it('simple mapped files include a reference to the source map', () => {
-            let file = program.addOrReplaceFile('source/logger.brs', (0, testHelpers_spec_1.trim) `
+            let file = program.setFile('source/logger.brs', (0, testHelpers_spec_1.trim) `
                 sub logInfo()
                 end sub
             `);
@@ -2015,7 +2165,7 @@ describe('BrsFile', () => {
             (0, chai_1.expect)(code.endsWith(`'//# sourceMappingURL=./logger.brs.map`)).to.be.true;
         });
         it('AST generated files include a reference to the source map', () => {
-            let file = program.addOrReplaceFile('source/logger.brs', (0, testHelpers_spec_1.trim) `
+            let file = program.setFile('source/logger.brs', (0, testHelpers_spec_1.trim) `
                 sub logInfo()
                 end sub
             `);
@@ -2024,7 +2174,7 @@ describe('BrsFile', () => {
             (0, chai_1.expect)(code.endsWith(`'//# sourceMappingURL=./logger.brs.map`)).to.be.true;
         });
         it('replaces custom types in parameter types and return types', () => {
-            program.addOrReplaceFile('source/SomeKlass.bs', `
+            program.setFile('source/SomeKlass.bs', `
                 class SomeKlass
                 end class
             `);
@@ -2048,14 +2198,13 @@ describe('BrsFile', () => {
     describe('callfunc operator', () => {
         describe('transpile', () => {
             it('does not produce diagnostics', () => {
-                var _a;
-                program.addOrReplaceFile('source/main.bs', `
+                program.setFile('source/main.bs', `
                     sub main()
                         someObject@.someFunction(paramObject.value)
                     end sub
                 `);
                 program.validate();
-                (0, chai_1.expect)((_a = program.getDiagnostics()[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
+                (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
             });
             it('sets invalid on empty callfunc', () => {
                 testTranspile(`
@@ -2095,13 +2244,12 @@ describe('BrsFile', () => {
                 name: 'transform callback',
                 afterFileParse: onParsed
             });
-            const file = new BrsFile_1.BrsFile(`absolute_path/file${ext}`, `relative_path/file${ext}`, program);
-            (0, chai_1.expect)(file.extension).to.equal(ext);
-            file.parse(`
+            file = program.setFile({ src: `absolute_path/file${ext}`, dest: `relative_path/file${ext}` }, `
                 sub Sum()
                     print "hello world"
                 end sub
             `);
+            (0, chai_1.expect)(file.extension).to.equal(ext);
             return file;
         }
         it('called for BRS file', () => {
@@ -2117,25 +2265,25 @@ describe('BrsFile', () => {
     });
     describe('typedefKey', () => {
         it('works for .brs files', () => {
-            (0, chai_1.expect)((0, util_1.standardizePath)((program.addOrReplaceFile('source/main.brs', '')).typedefKey)).to.equal((0, util_1.standardizePath) `${rootDir.toLowerCase()}/source/main.d.bs`);
+            (0, chai_1.expect)((0, util_1.standardizePath)((program.setFile('source/main.brs', '')).typedefKey)).to.equal((0, util_1.standardizePath) `${rootDir.toLowerCase()}/source/main.d.bs`);
         });
         it('returns undefined for files that should not have a typedef', () => {
-            (0, chai_1.expect)((program.addOrReplaceFile('source/main.bs', '')).typedefKey).to.be.undefined;
-            (0, chai_1.expect)((program.addOrReplaceFile('source/main.d.bs', '')).typedefKey).to.be.undefined;
-            const xmlFile = program.addOrReplaceFile('components/comp.xml', '');
+            (0, chai_1.expect)((program.setFile('source/main.bs', '')).typedefKey).to.be.undefined;
+            (0, chai_1.expect)((program.setFile('source/main.d.bs', '')).typedefKey).to.be.undefined;
+            const xmlFile = program.setFile('components/comp.xml', '');
             (0, chai_1.expect)(xmlFile.typedefKey).to.be.undefined;
         });
     });
     describe('type definitions', () => {
         it('only exposes defined functions even if source has more', () => {
             //parse the .brs file first so it doesn't know about the typedef
-            program.addOrReplaceFile('source/main.brs', `
+            program.setFile('source/main.brs', `
                 sub main()
                 end sub
                 sub speak()
                 end sub
             `);
-            program.addOrReplaceFile('source/main.d.bs', `
+            program.setFile('source/main.d.bs', `
                 sub main()
                 end sub
             `);
@@ -2145,7 +2293,7 @@ describe('BrsFile', () => {
             (0, chai_1.expect)(functionNames).not.to.include('speak');
         });
         it('reacts to typedef file changes', () => {
-            let file = program.addOrReplaceFile('source/main.brs', `
+            let file = program.setFile('source/main.brs', `
                 sub main()
                 end sub
                 sub speak()
@@ -2153,14 +2301,14 @@ describe('BrsFile', () => {
             `);
             (0, chai_1.expect)(file.hasTypedef).to.be.false;
             (0, chai_1.expect)(file.typedefFile).not.to.exist;
-            program.addOrReplaceFile('source/main.d.bs', `
+            program.setFile('source/main.d.bs', `
                 sub main()
                 end sub
             `);
             (0, chai_1.expect)(file.hasTypedef).to.be.true;
             (0, chai_1.expect)(file.typedefFile).to.exist;
             //add replace file, does it still find the typedef
-            file = program.addOrReplaceFile('source/main.brs', `
+            file = program.setFile('source/main.brs', `
                 sub main()
                 end sub
                 sub speak()
@@ -2175,36 +2323,36 @@ describe('BrsFile', () => {
     });
     describe('typedef', () => {
         it('sets typedef path properly', () => {
-            (0, chai_1.expect)((program.addOrReplaceFile('source/main1.brs', '')).typedefKey).to.equal((0, util_1.standardizePath) `${rootDir}/source/main1.d.bs`.toLowerCase());
-            (0, chai_1.expect)((program.addOrReplaceFile('source/main2.d.bs', '')).typedefKey).to.equal(undefined);
-            (0, chai_1.expect)((program.addOrReplaceFile('source/main3.bs', '')).typedefKey).to.equal(undefined);
+            (0, chai_1.expect)((program.setFile('source/main1.brs', '')).typedefKey).to.equal((0, util_1.standardizePath) `${rootDir}/source/main1.d.bs`.toLowerCase());
+            (0, chai_1.expect)((program.setFile('source/main2.d.bs', '')).typedefKey).to.equal(undefined);
+            (0, chai_1.expect)((program.setFile('source/main3.bs', '')).typedefKey).to.equal(undefined);
             //works for dest with `.brs` extension
-            (0, chai_1.expect)((program.addOrReplaceFile({ src: 'source/main4.bs', dest: 'source/main4.brs' }, '')).typedefKey).to.equal(undefined);
+            (0, chai_1.expect)((program.setFile({ src: 'source/main4.bs', dest: 'source/main4.brs' }, '')).typedefKey).to.equal(undefined);
         });
         it('does not link when missing from program', () => {
-            const file = program.addOrReplaceFile('source/main.brs', ``);
+            const file = program.setFile('source/main.brs', ``);
             (0, chai_1.expect)(file.typedefFile).not.to.exist;
         });
         it('links typedef when added BEFORE .brs file', () => {
-            const typedef = program.addOrReplaceFile('source/main.d.bs', ``);
-            const file = program.addOrReplaceFile('source/main.brs', ``);
+            const typedef = program.setFile('source/main.d.bs', ``);
+            const file = program.setFile('source/main.brs', ``);
             (0, chai_1.expect)(file.typedefFile).to.equal(typedef);
         });
         it('links typedef when added AFTER .brs file', () => {
-            const file = program.addOrReplaceFile('source/main.brs', ``);
-            const typedef = program.addOrReplaceFile('source/main.d.bs', ``);
+            const file = program.setFile('source/main.brs', ``);
+            const typedef = program.setFile('source/main.d.bs', ``);
             (0, chai_1.expect)(file.typedefFile).to.eql(typedef);
         });
         it('removes typedef link when typedef is removed', () => {
-            const typedef = program.addOrReplaceFile('source/main.d.bs', ``);
-            const file = program.addOrReplaceFile('source/main.brs', ``);
+            const typedef = program.setFile('source/main.d.bs', ``);
+            const file = program.setFile('source/main.brs', ``);
             program.removeFile(typedef.pathAbsolute);
             (0, chai_1.expect)(file.typedefFile).to.be.undefined;
         });
     });
     describe('getTypedef', () => {
         function testTypedef(original, expected) {
-            let file = program.addOrReplaceFile('source/main.brs', original);
+            let file = program.setFile('source/main.brs', original);
             (0, chai_1.expect)(file.getTypedef()).to.eql(expected);
         }
         it('includes namespace on extend class names', () => {
@@ -2455,7 +2603,7 @@ describe('BrsFile', () => {
     });
     describe('parser getter', () => {
         it('recreates the parser when missing', () => {
-            const file = program.addOrReplaceFile('source/main.brs', `
+            const file = program.setFile('source/main.brs', `
                 sub main()
                 end sub
             `);
@@ -2469,11 +2617,11 @@ describe('BrsFile', () => {
             (0, chai_1.expect)(file.parser).to.equal(newParser);
         });
         it('call parse when previously skipped', () => {
-            program.addOrReplaceFile('source/main.d.bs', `
+            program.setFile('source/main.d.bs', `'typedef
                 sub main()
                 end sub
             `);
-            const file = program.addOrReplaceFile('source/main.brs', `
+            const file = program.setFile('source/main.brs', `'source
                 sub main()
                 end sub
             `);