brighterscript 1.0.0-alpha.5 → 1.0.0-alpha.50

package/dist/bscPlugin/hover/HoverProcessor.spec.js

@@ -0,0 +1,991 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_config_spec_1 = require("../../chai-config.spec");
+const Program_1 = require("../../Program");
+const util_1 = require("../../util");
+const sinon_1 = require("sinon");
+const testHelpers_spec_1 = require("../../testHelpers.spec");
+const HoverProcessor_1 = require("./HoverProcessor");
+const creators_1 = require("../../astUtils/creators");
+let sinon = (0, sinon_1.createSandbox)();
+const fence = (code) => util_1.util.mdFence(code, 'brightscript');
+const commentSep = `\n***\n`;
+describe('HoverProcessor', () => {
+    let program;
+    beforeEach(() => {
+        program = new Program_1.Program({ rootDir: testHelpers_spec_1.rootDir, sourceMap: true });
+    });
+    afterEach(() => {
+        sinon.restore();
+        program.dispose();
+    });
+    it('does not short-circuit the event since our plugin is the base plugin', () => {
+        const mock = sinon.mock();
+        program.plugins.add({
+            name: 'test-plugin',
+            provideHover: mock
+        });
+        const file = program.setFile('source/main.brs', `
+            sub main()
+            end sub
+        `);
+        //get the hover
+        program.getHover(file.srcPath, util_1.util.createPosition(1, 20));
+        //the onGetHover function from `test-plugin` should always get called because
+        //BscPlugin should never short-circuit the event
+        (0, chai_config_spec_1.expect)(mock.called).to.be.true;
+    });
+    describe('BrsFile', () => {
+        it('getConstHover does not crash on expression with missing range', () => {
+            const file = program.setFile('source/main.bs', ``);
+            const processor = new HoverProcessor_1.HoverProcessor({});
+            const expression = (0, creators_1.createIntegerLiteral)('1');
+            (0, chai_config_spec_1.expect)(processor['getConstHover']((0, creators_1.createIdentifier)('hello'), file, program.getScopeByName('source'), expression)).to.eql(undefined);
+        });
+        it('works for param types', () => {
+            const file = program.setFile('source/main.brs', `
+                sub DoSomething(name as string)
+                    name = 1
+                    sayMyName = function(name as string)
+                    end function
+                end sub
+            `);
+            program.validate();
+            //hover over the `name = 1` line
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 24))[0];
+            (0, chai_config_spec_1.expect)(hover).to.exist;
+            (0, chai_config_spec_1.expect)(hover.range).to.eql(util_1.util.createRange(2, 20, 2, 24));
+            //hover over the `name` parameter declaration
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(1, 34))[0];
+            (0, chai_config_spec_1.expect)(hover).to.exist;
+            (0, chai_config_spec_1.expect)(hover.range).to.eql(util_1.util.createRange(1, 32, 1, 36));
+        });
+        //ignore this for now...it's not a huge deal
+        it('does not match on keywords or data types', () => {
+            let file = program.setFile('source/main.brs', `
+                sub Main(name as string)
+                end sub
+                sub as()
+                end sub
+            `);
+            //hover over the `as`
+            (0, chai_config_spec_1.expect)(program.getHover(file.srcPath, util_1.util.createPosition(1, 31))).to.be.empty;
+            //hover over the `string`
+            (0, chai_config_spec_1.expect)(program.getHover(file.srcPath, util_1.util.createPosition(1, 36))).to.be.empty;
+        });
+        it('finds declared function', () => {
+            let file = program.setFile('source/main.brs', `
+                function Main(count = 1)
+                    firstName = "bob"
+                    age = 21
+                    shoeSize = 10
+                end function
+            `);
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(1, 28))[0];
+            (0, chai_config_spec_1.expect)(hover).to.exist;
+            (0, chai_config_spec_1.expect)(hover.range).to.eql(util_1.util.createRange(1, 25, 1, 29));
+            (0, chai_config_spec_1.expect)(hover.contents).to.eql([fence('function Main(count? as integer) as dynamic')]);
+        });
+        it('finds declared namespace function', () => {
+            let file = program.setFile('source/main.brs', `
+            namespace mySpace
+                function Main(count = 1)
+                    firstName = "bob"
+                    age = 21
+                    shoeSize = 10
+                end function
+            end namespace
+            `);
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 28))[0];
+            (0, chai_config_spec_1.expect)(hover).to.exist;
+            (0, chai_config_spec_1.expect)(hover.range).to.eql(util_1.util.createRange(2, 25, 2, 29));
+            (0, chai_config_spec_1.expect)(hover.contents).to.eql([fence('function mySpace.Main(count? as integer) as dynamic')]);
+        });
+        it('finds variable function hover in same scope', () => {
+            let file = program.setFile('source/main.brs', `
+                sub Main()
+                    sayMyName = sub(name as string)
+                    end sub
+
+                    sayMyName()
+                end sub
+            `);
+            program.validate();
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(5, 24))[0];
+            (0, chai_config_spec_1.expect)(hover.range).to.eql(util_1.util.createRange(5, 20, 5, 29));
+            (0, chai_config_spec_1.expect)(hover.contents).to.eql([fence('sub sayMyName(name as string) as void')]);
+        });
+        it('does not crash when hovering on built-in functions', () => {
+            let file = program.setFile('source/main.brs', `
+                function doUcase(text)
+                    return ucase(text)
+                end function
+            `);
+            let commentSep = `\n***\n`;
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 30))[0];
+            (0, chai_config_spec_1.expect)(hover.contents).to.eql([`${fence('function ucase(s as string) as string')}${commentSep}Converts the string to all upper case.`]);
+        });
+        it('does not crash when hovering on object method call', () => {
+            let file = program.setFile('source/main.brs', `
+                function getInstr(url, text)
+                    return url.instr(text)
+                end function
+
+                function getInstrTyped(urlStr as string, text)
+                    return urlStr.instr(text)
+                end function
+            `);
+            program.validate();
+            // return url.ins|tr(text)
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 35))[0];
+            (0, chai_config_spec_1.expect)(hover.contents).to.eql(['```brightscript\ninstr as dynamic\n```']);
+            // return urlStr.ins|tr(text)
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(6, 38))[0];
+            (0, chai_config_spec_1.expect)(hover.contents[0]).to.include('```brightscript\nfunction string.instr(substringOrStart_index as string or integer, substring? as string) as integer\n```');
+            (0, chai_config_spec_1.expect)(hover.contents[0]).to.include('OVERLOADED METHOD');
+        });
+        it('finds function hover in file scope', () => {
+            let file = program.setFile('source/main.brs', `
+                sub Main()
+                    sayMyName()
+                end sub
+
+                sub sayMyName()
+                end sub
+            `);
+            program.validate();
+            //sayM|yName()
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 25))[0];
+            (0, chai_config_spec_1.expect)(hover.range).to.eql(util_1.util.createRange(2, 20, 2, 29));
+            (0, chai_config_spec_1.expect)(hover.contents).to.eql([fence('sub sayMyName() as void')]);
+        });
+        it('finds function hover in scope', () => {
+            let mainFile = program.setFile('source/main.brs', `
+                sub Main()
+                    sayMyName()
+                end sub
+            `);
+            program.setFile('source/lib.brs', `
+                sub sayMyName(name as string)
+
+                end sub
+            `);
+            program.validate();
+            let hover = program.getHover(mainFile.srcPath, util_1.util.createPosition(2, 25))[0];
+            (0, chai_config_spec_1.expect)(hover.range).to.eql(util_1.util.createRange(2, 20, 2, 29));
+            (0, chai_config_spec_1.expect)(hover.contents).to.eql([fence('sub sayMyName(name as string) as void')]);
+        });
+        it('finds top-level constant value', () => {
+            program.setFile('source/main.bs', `
+                sub main()
+                    print SOME_VALUE
+                end sub
+                const SOME_VALUE = true
+            `);
+            program.validate();
+            // print SOM|E_VALUE
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(2, 29))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(2, 26, 2, 36));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('const SOME_VALUE = true as boolean')]);
+        });
+        it('finds top-level constant in assignment expression', () => {
+            program.setFile('source/main.bs', `
+                sub main()
+                    value = ""
+                    value += SOME_VALUE
+                end sub
+                const SOME_VALUE = "value"
+            `);
+            program.validate();
+            // value += SOME|_VALUE
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(3, 33))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(3, 29, 3, 39));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('const SOME_VALUE = "value" as string')]);
+        });
+        it('finds namespaced constant in assignment expression', () => {
+            program.setFile('source/main.bs', `
+                sub main()
+                    value = ""
+                    value += someNamespace.SOME_VALUE
+                end sub
+                namespace someNamespace
+                    const SOME_VALUE = "value"
+                end namespace
+            `);
+            program.validate();
+            // value += SOME|_VALUE
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(3, 47))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(3, 43, 3, 53));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('const someNamespace.SOME_VALUE = "value" as string')]);
+        });
+        it('finds namespaced constant value', () => {
+            program.setFile('source/main.bs', `
+                sub main()
+                    print name.SOME_VALUE
+                end sub
+                namespace name
+                    const SOME_VALUE = true
+                end namespace
+            `);
+            program.validate();
+            // print name.SOM|E_VALUE
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(2, 34))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(2, 31, 2, 41));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('const name.SOME_VALUE = true as boolean')]);
+        });
+        it('finds constant value that is an array', () => {
+            program.setFile('source/main.bs', `
+                sub main()
+                    print SOME_VALUE
+                end sub
+                const SOME_VALUE = [] as function[]
+            `);
+            program.validate();
+            // print SOM|E_VALUE
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(2, 30))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(2, 26, 2, 36));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('const SOME_VALUE = [] as Array<function>')]);
+        });
+        it('finds deep namespaced constant value', () => {
+            program.setFile('source/main.bs', `
+                sub main()
+                    print name.sp.a.c.e.SOME_VALUE
+                end sub
+                namespace name.sp.a.c.e
+                    const SOME_VALUE = true
+                end namespace
+            `);
+            program.validate();
+            // print name.sp.a.c.e.SOM|E_VALUE
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(2, 43))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(2, 40, 2, 50));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('const name.sp.a.c.e.SOME_VALUE = true as boolean')]);
+        });
+        it('finds namespaced class types', () => {
+            program.setFile('source/main.bs', `
+                sub main()
+                    myKlass = new name.Klass()
+                    runNoop(myKlass)
+                end sub
+
+                sub runNoop(myKlass as name.Klass)
+                    myKlass.noop()
+                end sub
+
+                namespace name
+                    class Klass
+                        sub noop()
+                        end sub
+                    end class
+                end namespace
+            `);
+            program.validate();
+            // run|Noop(myKlass)
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(3, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(3, 20, 3, 27));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('sub runNoop(myKlass as name.Klass) as void')]);
+            // myKl|ass.noop()
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(7, 25))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(7, 20, 7, 27));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('myKlass as name.Klass')]);
+            //  sub no|op()
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(12, 31))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('sub name.Klass.noop() as void')]);
+        });
+        it('finds local variables that shadow namespaces', () => {
+            program.setFile('source/main.bs', `
+                sub foo1(alpha as string)
+                    print alpha.toStr() ' in foo1()
+                end sub
+
+                sub foo2()
+                    alpha = 123
+                    print alpha.toStr() ' in foo2()
+                end sub
+
+                namespace alpha
+                    function toStr()
+                        return "alpha"
+                    end function
+                end namespace
+            `);
+            program.validate();
+            //  sub foo1(alp|ha as string)
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(1, 29))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('alpha as string')]);
+            // print alp|ha.toStr() ' in foo1()
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(2, 30))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('alpha as string')]);
+            //  alp|ha = 123
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(6, 23))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('alpha as integer')]);
+            //  print alp|ha.toStr() ' in foo2()
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(7, 30))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('alpha as integer')]);
+        });
+        it('finds types properly', () => {
+            program.setFile('source/main.bs', `
+                class Person
+                end class
+
+                sub doWork(age as integer, name as string, guy as Person)
+                end sub
+            `);
+            program.validate();
+            // a|ge as integer
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(4, 29))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(4, 27, 4, 30));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('age as integer')]);
+            // age as int|eger
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(4, 39))[0];
+            // no hover on base types
+            (0, chai_config_spec_1.expect)(hover).to.be.undefined;
+            // n|ame as string
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(4, 46))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(4, 43, 4, 47));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('name as string')]);
+            // name as st|ring
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(4, 54))[0];
+            // no hover on base types
+            (0, chai_config_spec_1.expect)(hover).to.be.undefined;
+            // gu|y as Person
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(4, 60))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(4, 59, 4, 62));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('guy as Person')]);
+            // guy as Pe|rson
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(4, 69))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('class Person')]);
+        });
+        it('finds namespaces properly', () => {
+            program.setFile('source/main.bs', `
+                namespace Name1
+                   namespace Name2
+                      const hi = "hello"
+                   end namespace
+                end namespace
+
+                sub doWork()
+                   print Name1.Name2.hi
+                end sub
+            `);
+            program.validate();
+            // print Name1.Nam|e2.hi
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(8, 36))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('namespace Name1.Name2')]);
+        });
+        it('finds enum properly', () => {
+            program.setFile('source/main.bs', `
+                enum Direction
+                    up
+                    down
+                end enum
+
+                sub doWork()
+                   print Direction.up
+                end sub
+            `);
+            program.validate();
+            // print Dire|ction.up
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(7, 30))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('enum Direction')]);
+            // print Direction.u|p
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(7, 37))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('Direction.up as Direction')]);
+        });
+        it('finds types hover with comment', () => {
+            program.setFile('source/main.bs', `
+                ' this is a class comment
+                ' it is more than one line
+                class Person
+                end class
+
+                ' does some work
+                sub doWork(age as integer, name as string, guy as Person)
+                end sub
+            `);
+            program.validate();
+            // gu|y as Person
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(7, 60))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(7, 59, 7, 62));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('guy as Person')}${commentSep}this is a class comment\nit is more than one line`]);
+            // guy as Pe|rson
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(7, 69))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('class Person')}${commentSep}this is a class comment\nit is more than one line`]);
+        });
+        it('finds types from assignments defined in different file', () => {
+            program.setFile(`source/main.bs`, `
+                sub main()
+                    thing = new MyKlass()
+                    useKlass(thing)
+                    someVal = getValue()
+                    print someVal
+                end sub
+
+                sub useKlass(thing as MyKlass)
+                    print thing
+                end sub
+            `);
+            program.setFile(`source/MyKlass.bs`, `
+                class MyKlass
+                end class
+            `);
+            program.setFile(`source/util.bs`, `
+                function getValue() as string
+                    return "hello"
+                end function
+            `);
+            program.validate();
+            //th|ing = new MyKlass()
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(2, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(2, 20, 2, 25));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('thing as MyKlass')]);
+            //print some|Val
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(5, 31))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(5, 26, 5, 33));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('someVal as string')]);
+        });
+        it('hovers of functions include comments', () => {
+            program.setFile(`source/main.bs`, `
+                sub main()
+                    thing = new MyKlass()
+                    useKlass(thing)
+                end sub
+
+                ' Prints a MyKlass.name
+                sub useKlass(thing as MyKlass)
+                    print thing.getName()
+                end sub
+
+                ' A sample class
+                class MyKlass
+                    name as string
+
+                    ' Gets the name of this thing
+                    function getName() as string
+                        return m.name
+                    end function
+
+                    ' Wraps another function
+                    function getNameWrap() as string
+                        return m.getName()
+                    end function
+                end class
+            `);
+            program.validate();
+            let commentSep = `\n***\n`;
+            //th|ing = new MyKlass()
+            let hover = program.getHover('source/main.bs', util_1.util.createPosition(2, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('thing as MyKlass')}`]);
+            //thing = new MyK|lass()
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(2, 37))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('class MyKlass')}${commentSep}A sample class`]);
+            //use|Klass(thing)
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(3, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('sub useKlass(thing as MyKlass) as void')}${commentSep}Prints a MyKlass.name`]);
+            //print thing.getN|ame()
+            hover = program.getHover('source/main.bs', util_1.util.createPosition(8, 37))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('function MyKlass.getName() as string')}${commentSep}Gets the name of this thing`]);
+        });
+        it('finds globalCallables with documentation', () => {
+            let mainFile = program.setFile('source/main.brs', `
+                sub Main()
+                    print lcase("HELLO")
+                end sub
+            `);
+            program.validate();
+            //    print lc|ase("HELLO")
+            let hover = program.getHover(mainFile.srcPath, util_1.util.createPosition(2, 29))[0];
+            (0, chai_config_spec_1.expect)(hover.contents).to.eql([`${fence('function lcase(s as string) as string')}${commentSep}Converts the string to all lower case.`]);
+        });
+        it('finds functions as params', () => {
+            program.setFile('source/main.brs', `
+                function getStrLength(name as string) as integer
+                    return len(name)
+                end function
+
+                sub tryManyParams(someFunc as function)
+                    print someFunc(1, 2, "hello", "world")
+                end sub
+
+                sub test()
+                    tryManyParams(getStrLength)
+                end sub
+            `);
+            program.validate();
+            // print some|Func(1, 2, "hello", "world")
+            let hover = program.getHover('source/main.brs', util_1.util.createPosition(6, 31))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(6, 26, 6, 34));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('someFunc as function')]);
+        });
+        it('keeps unresolved types as type names', () => {
+            const file = program.setFile('source/main.bs', `
+                sub doSomething(thing as UnknownType)
+                    print thing
+                end sub
+            `);
+            program.validate();
+            // print thi|ng
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 30))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(2, 26, 2, 31));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('thing as UnknownType')]);
+        });
+        it('says members on dynamic are dynamic', () => {
+            const file = program.setFile('source/main.bs', `
+                sub doSomething(thing)
+                    print thing.member
+                end sub
+            `);
+            program.validate();
+            // print thing.mem|ber
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 36))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.range).to.eql(util_1.util.createRange(2, 32, 2, 38));
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('member as dynamic')]);
+        });
+        it('should recognize consistent type after function call in binary op', () => {
+            let file = program.setFile('source/main.bs', `
+                function arrayToString(items as object) as string
+                    description = "["
+                    for each item in items
+                        description += utils.toString(item) + ", "
+                    end for
+                    description += "]"
+                    return description
+                end function
+            `);
+            program.setFile('source/utils.bs', `
+                namespace utils
+                    function toString(thing as dynamic) as string
+                        return "hello"
+                    end function
+                end namespace
+            `);
+            program.validate();
+            // return myS|tring
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(7, 31))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('description as string')]);
+        });
+        it('should provide correct hover for LHS of assignment', () => {
+            let file = program.setFile('source/main.bs', `
+                function getFloat() as float
+                    return 123
+                end function
+
+                sub doStuff()
+                    myFloat = getFloat()
+                end sub
+            `);
+            program.validate();
+            //     myF|loat = getFloat()
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(6, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('myFloat as float')]);
+        });
+        it('should provide correct hover for members of classes', () => {
+            let file = program.setFile('source/main.bs', `
+                class SomeKlass
+                    name as string
+                    other as OtherKlass
+                    myLabel as roSGNodeLabel
+                end class
+
+                class OtherKlass
+                    size as integer
+                end class
+            `);
+            program.validate();
+            //     na|me as string
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('SomeKlass.name as string')]);
+            //    ot|her as OtherKlass
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('SomeKlass.other as OtherKlass')]);
+            //     my|Label as RoSGNodeLabel
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(4, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('SomeKlass.myLabel as roSGNodeLabel')]);
+        });
+        it('should provide correct hover for members of interfaces', () => {
+            let file = program.setFile('source/main.bs', `
+                interface SomeIFace
+                    name as string
+                    other as OtherIFace
+                    myLabel as roSGNodeLabel
+                end interface
+
+                interface OtherIFace
+                    size as integer
+                end interface
+            `);
+            program.validate();
+            //     na|me as string
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('SomeIFace.name as string')]);
+            //    ot|her as OtherIFace
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('SomeIFace.other as OtherIFace')]);
+            //     my|Label as RoSGNodeLabel
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(4, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('SomeIFace.myLabel as roSGNodeLabel')]);
+        });
+        it('should include leading trivia of member field hover', () => {
+            let file = program.setFile('source/main.bs', `
+                interface SomeIFace
+                    ' Some description
+                    name as string
+                    other as OtherIFace
+                    myLabel as roSGNodeLabel
+                end interface
+            `);
+            program.validate();
+            //     na|me as string
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 24))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('SomeIFace.name as string')}${commentSep}Some description`]);
+        });
+        it('should include leading trivia of enum member field hover', () => {
+            let file = program.setFile('source/main.bs', `
+                enum Direction
+                    ' Go Up
+                    up  = "up"
+                    down =  "down"
+                end enum
+            `);
+            program.validate();
+            //    u|p  = "up"
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 22))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('Direction.up as Direction')}${commentSep}Go Up`]);
+        });
+        it('should have correct hovers for loop-items of for-loops', () => {
+            let file = program.setFile('source/main.bs', `
+                sub test()
+                    for index = 0 to 10
+                        print index
+                    end for
+                end sub
+            `);
+            program.validate();
+            //    for in|dex = 0 to 10
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 27))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('index as integer')]);
+        });
+        it('should have correct hovers for loop-items of for-each-loops', () => {
+            let file = program.setFile('source/main.bs', `
+                sub test()
+                    numbers = [1,2,3]
+                    for each number in numbers
+                        print number
+                    end for
+                end sub
+            `);
+            program.validate();
+            //    for each number in num|bers
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 43))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('numbers as Array<integer>')]);
+            //    for each num|ber in numbers
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 33))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('number as integer')]);
+            //    for each number i|n numbers
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 38))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.be.undefined;
+        });
+        it('should have correct hovers for loop-items of for-each-loops', () => {
+            let file = program.setFile('source/main.bs', `
+                sub test(strArray)
+                    for each thing as string in strArray
+                        print thing
+                    end for
+                end sub
+            `);
+            program.validate();
+            //    for each thing as string in str|Array
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 52))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('strArray as dynamic')]);
+            //    print th|ing
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 33))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([fence('thing as string')]);
+        });
+        it('should show unresolved members as invalid', () => {
+            const file = program.setFile('source/main.bs', `
+                    interface MyIFace
+                        name as string
+                    end interface
+
+                    sub doSomething(thing as MyIFace)
+                        print thing.member
+                    end sub
+                `);
+            program.validate();
+            // print thing.mem|ber
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(6, 40))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('MyIFace.member as invalid')]);
+        });
+        it('has m as an AA in inline function', () => {
+            const file = program.setFile('source/main.bs', `
+                class Test
+                    sub method()
+                        stub = function()
+                            m.whatever = false
+                        end function
+                    end sub
+                end class
+            `);
+            program.validate();
+            // |m.whatever = false
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(4, 29))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('m as roAssociativeArray')]);
+            // m.what|ever = false
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(4, 35))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('whatever as dynamic')]);
+        });
+        it('should include leading Trivia of inline interface members', () => {
+            const file = program.setFile('source/main.bs', `
+                ' @param input from doc comment
+                sub fooFunc(input as {
+                    ' description of name prop
+                    name as string
+                })
+                    print input.name
+                end sub
+            `);
+            program.validate();
+            // print input.na|me
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(6, 35))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('{name as string}.name as string')}${commentSep}description of name prop`]);
+            // print in|put.name
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(6, 29))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).to.eql([`${fence('input as {name as string}')}${commentSep}from doc comment`]);
+        });
+    });
+    describe('callFunc', () => {
+        it('should get hovers on @callfunc invocations', () => {
+            program.setFile('components/Widget.xml', (0, testHelpers_spec_1.trim) `
+                <?xml version="1.0" encoding="utf-8" ?>
+                <component name="Widget" extends="Group">
+                     <script uri="Widget.bs"/>
+                    <interface>
+                        <function name="someFunc" />
+                    </interface>
+                </component>
+            `);
+            const file = program.setFile('components/Widget.bs', `
+                sub foo()
+                    top = m.top as roSgNodeWidget
+                    print top@.someFunc("3.14")
+                end sub
+
+                function someFunc(input as string) as float
+                    return input.toFloat()
+                end function
+            `);
+            program.validate();
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
+            // print top@.some|Func("3.14")
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 35))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('function roSGNodeWidget@.someFunc(input as string) as float')]);
+        });
+        it('should include documentation on @callfunc hovers', () => {
+            program.setFile('components/Widget.xml', (0, testHelpers_spec_1.trim) `
+                <?xml version="1.0" encoding="utf-8" ?>
+                <component name="Widget" extends="Group">
+                     <script uri="Widget.bs"/>
+                    <interface>
+                        <function name="someFunc" />
+                    </interface>
+                </component>
+            `);
+            const file = program.setFile('components/Widget.bs', `
+                sub foo()
+                    top = m.top as roSgNodeWidget
+                    print top@.someFunc("3.14")
+                end sub
+
+                ' Some Cool function
+                function someFunc(input as string) as float
+                    return input.toFloat()
+                end function
+            `);
+            program.validate();
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
+            // print top@.some|Func("3.14")
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 35))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents[0]).include('Some Cool function');
+        });
+    });
+    describe('multiple definition locations', () => {
+        it('gets hover on assignment node', () => {
+            const file = program.setFile('source/util.bs', `
+                sub test(obj as Data)
+                    myVar = obj.name ' setting type to string
+                end sub
+
+                interface Data
+                    name as string
+                end interface
+            `);
+            program.validate();
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
+            //  my|Var = obj.name
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 22))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`myVar as string`)]);
+        });
+        it('shows correct type in all locations', () => {
+            const file = program.setFile('source/util.bs', `
+                sub test()
+                    myVar = "hello" ' setting type to string
+                    print 1; myVar
+                    myVar = "hello".len()  ' setting type to integer
+                    print 2; myVar
+                    myVar = sqr(33)  ' setting type to float
+                    print 3; myVar
+                end sub
+            `);
+            program.validate();
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
+            // print 1; my|Var
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 31))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`myVar as string`)]);
+            // my|Var = "hello".len()
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(4, 23))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`myVar as integer`)]);
+            // print 2; my|Var
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(7, 31))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`myVar as float`)]);
+        });
+        it('reusing same variable for multiple types', () => {
+            const file = program.setFile('source/util.bs', `
+                namespace stringUtil
+                    function pad(x as string or integer) as string
+                        return "0"+x.toStr()
+                    end function
+                end namespace
+
+                ' Formats a timestamp into a user friendly string.
+                ' @param {Integer} time - The unix time stamp to format.
+                ' @param {String} meridiemStyle - A style key to be wrapped around the meridiem for MultiStyleLabels.
+                ' @return {String} - The formatted time
+                function formatTime(time as integer, meridiemStyle = "" as string) as string
+                    dateObj = createObject("roDateTime")
+                    deviceInfo = createObject("roDeviceInfo")
+                    dateObj.fromSeconds(time)
+                    hour = dateObj.getHours()
+                    minutes = dateObj.getMinutes()
+
+                    ' Get the Meridiem value
+                    if hour > 11 then
+                        meridiem = "pm"
+                    else
+                        meridiem = "am"
+                    end if
+
+                    if meridiemStyle <> "" then
+                        meridiem = "<" + meridiemStyle + ">" + meridiem + "</" + meridiemStyle + ">"
+                    end if
+
+                    minutes = stringUtil.pad(minutes)
+
+                    if deviceInfo.getClockFormat() = "24h" then
+                        hour = stringUtil.pad(hour)
+                        ' "22:01" | "01:01"
+                        return substitute("{0}:{1}", hour as string, minutes as string)
+                    else
+                        hour = hour mod 12
+                        if hour = 0 then hour = 12
+                        ' "10:01 AM" | "1:01 AM"
+                        return substitute("{0}:{1} {2}", hour.toStr(), minutes as string, meridiem)
+                    end if
+                end function
+            `);
+            program.validate();
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
+            // ho|ur = stringUtil.pad(hour)
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(32, 27))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`hour as string`)]);
+            // ho|ur = hour mod 12
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(36, 27))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`hour as integer`)]);
+        });
+        it('reusing same variable for multiple types - multiple hovers', () => {
+            const file = program.setFile('source/util.bs', `
+                function foo(toggle as boolean) as string
+                    someVar = "hello"
+                    print someVar; 1
+                    if toggle
+                        print someVar; 2
+                        someVar = 1
+                        print someVar; 3
+                    else
+                        print someVar; 4
+                        someVar = 0
+                        print someVar; 5
+                    end if
+                    print someVar; 6
+                    return someVar.toStr()
+                end function
+            `);
+            program.validate();
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
+            // some|Var = "hello"
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 25))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as string`)]);
+            // print some|Var; 1
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 31))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as string`)]);
+            // print some|Var; 2
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(5, 35))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as string`)]);
+            // some|Var = 1
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(6, 29))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as integer`)]);
+            // print some|Var; 3
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(7, 35))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as integer`)]);
+            // print some|Var; 4
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(9, 35))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as string`)]);
+            // some|Var = 0
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(10, 29))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as integer`)]);
+            // print some|Var; 5
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(11, 35))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as integer`)]);
+            // print some|Var; 6
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(13, 31))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as integer`)]);
+            // return some|Var.toStr()
+            hover = program.getHover(file.srcPath, util_1.util.createPosition(14, 32))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence(`someVar as integer`)]);
+        });
+    });
+    describe('doc type definitions', () => {
+        it('should show correct hover for params', () => {
+            const file = program.setFile('source/test.bs', `
+                namespace alpha
+                    '@param {DataType} data
+                    sub printName(data)
+                        print data.name
+                    end sub
+
+                    interface DataType
+                        name as string
+                    end interface
+                end namespace
+            `);
+            program.validate();
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
+            // sub printName(da|ta)
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(3, 37))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([fence('data as alpha.DataType')]);
+        });
+        it('should include doc comment descriptions in hover for params', () => {
+            const file = program.setFile('source/test.bs', `
+                '@param {string} data A cool JSON string of data
+                sub printName(data)
+                    print data
+                end sub
+            `);
+            program.validate();
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(program);
+            // sub printName(da|ta)
+            let hover = program.getHover(file.srcPath, util_1.util.createPosition(2, 33))[0];
+            (0, chai_config_spec_1.expect)(hover === null || hover === void 0 ? void 0 : hover.contents).eql([`${fence('data as string')}${commentSep}A cool JSON string of data`]);
+        });
+    });
+});
+//# sourceMappingURL=HoverProcessor.spec.js.map