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

package/dist/parser/Parser.Class.spec.js

@@ -1,69 +1,74 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
+const chai_config_spec_1 = require("../chai-config.spec");
 const DiagnosticMessages_1 = require("../DiagnosticMessages");
-const lexer_1 = require("../lexer");
+const TokenKind_1 = require("../lexer/TokenKind");
+const Lexer_1 = require("../lexer/Lexer");
 const Parser_1 = require("./Parser");
 const Statement_1 = require("./Statement");
 const Expression_1 = require("./Expression");
+const testHelpers_spec_1 = require("../testHelpers.spec");
+const reflection_1 = require("../astUtils/reflection");
+const StringType_1 = require("../types/StringType");
+const util_1 = require("../util");
 describe('parser class', () => {
     it('throws exception when used in brightscript scope', () => {
         var _a;
-        let { tokens } = lexer_1.Lexer.scan(`
+        let { tokens } = Lexer_1.Lexer.scan(`
                 class Person
                 end class
             `);
         let { diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrightScript });
-        chai_1.expect((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.code).to.equal(DiagnosticMessages_1.DiagnosticMessages.bsFeatureNotSupportedInBrsFiles('').code);
+        (0, chai_config_spec_1.expect)((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.code).to.equal(DiagnosticMessages_1.DiagnosticMessages.bsFeatureNotSupportedInBrsFiles('').code);
     });
-    for (let keyword of lexer_1.AllowedProperties) {
+    for (let keyword of TokenKind_1.AllowedProperties) {
         //skip a few of the class-specific keywords that are not allowed as field/method names
         if ([
-            lexer_1.TokenKind.Function,
-            lexer_1.TokenKind.Rem,
-            lexer_1.TokenKind.Sub,
-            lexer_1.TokenKind.Public,
-            lexer_1.TokenKind.Protected,
-            lexer_1.TokenKind.Private,
-            lexer_1.TokenKind.Override
+            TokenKind_1.TokenKind.Function,
+            TokenKind_1.TokenKind.Rem,
+            TokenKind_1.TokenKind.Sub,
+            TokenKind_1.TokenKind.Public,
+            TokenKind_1.TokenKind.Protected,
+            TokenKind_1.TokenKind.Private,
+            TokenKind_1.TokenKind.Override
         ].includes(keyword)) {
             continue;
         }
         it(`supports ${keyword} as property name`, () => {
             //test as property
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                 class Person
                     ${keyword} as string
                 end class
             `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics).to.be.lengthOf(0);
-            chai_1.expect(statements[0]).instanceof(Statement_1.ClassStatement);
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)(diagnostics).to.be.lengthOf(0);
+            (0, chai_config_spec_1.expect)(ast.statements[0]).instanceof(Statement_1.ClassStatement);
         });
         it(`supports ${keyword} as method name`, () => {
             var _a;
             //test as property
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                 class Person
                    sub ${keyword}()
                    end sub
                 end class
             `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
-            chai_1.expect(statements[0]).instanceof(Statement_1.ClassStatement);
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
+            (0, chai_config_spec_1.expect)(ast.statements[0]).instanceof(Statement_1.ClassStatement);
         });
     }
-    for (let keyword of lexer_1.AllowedLocalIdentifiers) {
+    for (let keyword of TokenKind_1.AllowedLocalIdentifiers) {
         it(`supports ${keyword} as class name`, () => {
             //test as property
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                 class ${keyword}
                 end class
             `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics).to.be.lengthOf(0);
-            chai_1.expect(statements[0]).instanceof(Statement_1.ClassStatement);
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)(diagnostics).to.be.lengthOf(0);
+            (0, chai_config_spec_1.expect)(ast.statements[0]).instanceof(Statement_1.ClassStatement);
         });
     }
     it('does not allow "throw" to be defined as a local var', () => {
@@ -74,7 +79,7 @@ describe('parser class', () => {
                 throw = true
             end sub
         `);
-        chai_1.expect((_a = parser.diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.eql(DiagnosticMessages_1.DiagnosticMessages.foundUnexpectedToken('=').message);
+        (0, chai_config_spec_1.expect)((_a = parser.diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.eql(DiagnosticMessages_1.DiagnosticMessages.unexpectedToken('=').message);
     });
     it('does not allow function named "throw"', () => {
         var _a;
@@ -83,7 +88,31 @@ describe('parser class', () => {
             sub throw()
             end sub
         `);
-        chai_1.expect((_a = parser.diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.eql(DiagnosticMessages_1.DiagnosticMessages.cannotUseReservedWordAsIdentifier('throw').message);
+        (0, chai_config_spec_1.expect)((_a = parser.diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.eql(DiagnosticMessages_1.DiagnosticMessages.cannotUseReservedWordAsIdentifier('throw').message);
+    });
+    it('does not allow function param named "type"', () => {
+        const parser = Parser_1.Parser.parse(`
+            sub test(type as string)
+            end sub
+        `);
+        (0, testHelpers_spec_1.expectDiagnostics)(parser, [Object.assign(Object.assign({}, DiagnosticMessages_1.DiagnosticMessages.cannotUseReservedWordAsIdentifier('type')), { location: util_1.default.createLocation(1, 21, 1, 25) })]);
+    });
+    it('does not allow class method named "type"', () => {
+        const parser = Parser_1.Parser.parse(`
+            class Person
+                sub test(type as string)
+                end sub
+            end class
+        `, { mode: Parser_1.ParseMode.BrighterScript });
+        (0, testHelpers_spec_1.expectDiagnostics)(parser, [Object.assign(Object.assign({}, DiagnosticMessages_1.DiagnosticMessages.cannotUseReservedWordAsIdentifier('type')), { location: util_1.default.createLocation(2, 25, 2, 29) })]);
+    });
+    it('does not allow interface method named "type"', () => {
+        const parser = Parser_1.Parser.parse(`
+            interface Person
+                sub test(type as string)
+            end interface
+        `, { mode: Parser_1.ParseMode.BrighterScript });
+        (0, testHelpers_spec_1.expectDiagnostics)(parser, [Object.assign(Object.assign({}, DiagnosticMessages_1.DiagnosticMessages.cannotUseReservedWordAsIdentifier('type')), { location: util_1.default.createLocation(2, 25, 2, 29) })]);
     });
     it('supports the try/catch keywords in various places', () => {
         var _a;
@@ -129,161 +158,161 @@ describe('parser class', () => {
             ' sub throw()
             ' end sub
         `);
-        chai_1.expect((_a = parser.diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
+        (0, chai_config_spec_1.expect)((_a = parser.diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
     });
     it('parses empty class', () => {
-        let { tokens } = lexer_1.Lexer.scan(`
+        let { tokens } = Lexer_1.Lexer.scan(`
                 class Person
                 end class
             `);
-        let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-        chai_1.expect(diagnostics).to.be.lengthOf(0);
-        chai_1.expect(statements[0]).instanceof(Statement_1.ClassStatement);
+        let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+        (0, chai_config_spec_1.expect)(diagnostics).to.be.lengthOf(0);
+        (0, chai_config_spec_1.expect)(ast.statements[0]).instanceof(Statement_1.ClassStatement);
     });
     it('bad property does not invalidate next sibling method', () => {
-        let { tokens } = lexer_1.Lexer.scan(`
+        let { tokens } = Lexer_1.Lexer.scan(`
                 class Person
                     public firstname =
                     public sub new()
                     end sub
                 end class
             `);
-        let { statements } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-        let classStatement = statements[0];
-        chai_1.expect(classStatement.methods[0]).to.exist;
-        chai_1.expect(classStatement.methods[0].name.text).to.equal('new');
+        let { ast } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+        let classStatement = ast.statements[0];
+        (0, chai_config_spec_1.expect)(classStatement.methods[0]).to.exist;
+        (0, chai_config_spec_1.expect)(classStatement.methods[0].tokens.name.text).to.equal('new');
     });
     it('catches class without name', () => {
-        let { tokens } = lexer_1.Lexer.scan(`
+        let { tokens } = Lexer_1.Lexer.scan(`
                 class
                 end class
             `);
-        let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-        chai_1.expect(diagnostics).length.to.be.greaterThan(0);
-        chai_1.expect(diagnostics[0].code).to.equal(DiagnosticMessages_1.DiagnosticMessages.expectedIdentifierAfterKeyword('class').code);
-        chai_1.expect(statements[0]).instanceof(Statement_1.ClassStatement);
+        let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+        (0, chai_config_spec_1.expect)(diagnostics).length.to.be.greaterThan(0);
+        (0, chai_config_spec_1.expect)(diagnostics[0].code).to.equal(DiagnosticMessages_1.DiagnosticMessages.expectedIdentifier('class').code);
+        (0, chai_config_spec_1.expect)(ast.statements[0]).instanceof(Statement_1.ClassStatement);
     });
     it('catches malformed class', () => {
-        let { tokens } = lexer_1.Lexer.scan(`
+        let { tokens } = Lexer_1.Lexer.scan(`
                 class Person
             `);
-        let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-        chai_1.expect(diagnostics).length.to.be.greaterThan(0);
-        chai_1.expect(statements[0]).instanceof(Statement_1.ClassStatement);
+        let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+        (0, chai_config_spec_1.expect)(diagnostics).length.to.be.greaterThan(0);
+        (0, chai_config_spec_1.expect)(ast.statements[0]).instanceof(Statement_1.ClassStatement);
     });
     describe('fields', () => {
         it('identifies perfect syntax', () => {
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                     class Person
                         public firstName as string
                     end class
                 `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics).to.be.empty;
-            chai_1.expect(statements[0]).instanceof(Statement_1.ClassStatement);
-            let field = statements[0].body[0];
-            chai_1.expect(field.accessModifier.kind).to.equal(lexer_1.TokenKind.Public);
-            chai_1.expect(field.name.text).to.equal('firstName');
-            chai_1.expect(field.as.text).to.equal('as');
-            chai_1.expect(field.type.text).to.equal('string');
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)(diagnostics).to.be.empty;
+            (0, chai_config_spec_1.expect)(ast.statements[0]).instanceof(Statement_1.ClassStatement);
+            let field = ast.statements[0].body[0];
+            (0, chai_config_spec_1.expect)(field.tokens.accessModifier.kind).to.equal(TokenKind_1.TokenKind.Public);
+            (0, chai_config_spec_1.expect)(field.tokens.name.text).to.equal('firstName');
+            (0, chai_config_spec_1.expect)(field.tokens.as.text).to.equal('as');
+            (0, chai_config_spec_1.expect)(field.getType({ flags: 2 /* SymbolTypeFlag.typetime */ })).to.be.instanceOf(StringType_1.StringType);
         });
         it('can be solely an identifier', () => {
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                     class Person
                         firstName
                     end class
                 `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics).to.be.lengthOf(0);
-            let cls = statements[0];
-            chai_1.expect(cls.fields[0].name.text).to.equal('firstName');
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)(diagnostics).to.be.lengthOf(0);
+            let cls = ast.statements[0];
+            (0, chai_config_spec_1.expect)(cls.fields[0].tokens.name.text).to.equal('firstName');
         });
         it('malformed field does not impact leading and trailing fields', () => {
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                     class Person
                         firstName as string
                         middleName asdf asdf asdf
                         lastName as string
                     end class
                 `);
-            let { statements } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            let cls = statements[0];
-            chai_1.expect(cls.fields[0].name.text).to.equal('firstName');
-            chai_1.expect(cls.fields[cls.fields.length - 1].name.text).to.equal('lastName');
+            let { ast } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            let cls = ast.statements[0];
+            (0, chai_config_spec_1.expect)(cls.fields[0].tokens.name.text).to.equal('firstName');
+            (0, chai_config_spec_1.expect)(cls.fields[cls.fields.length - 1].tokens.name.text).to.equal('lastName');
         });
         it(`detects missing type after 'as' keyword`, () => {
-            let { tokens } = lexer_1.Lexer.scan(`
-                    class Person
-                        middleName as
-                    end class
-                `);
-            let { diagnostics, statements } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics.length).to.be.greaterThan(0);
-            let cls = statements[0];
-            chai_1.expect(cls.fields[0].name.text).to.equal('middleName');
-            chai_1.expect(diagnostics[0].code).to.equal(DiagnosticMessages_1.DiagnosticMessages.expectedIdentifierAfterKeyword('as').code);
+            let { tokens } = Lexer_1.Lexer.scan(`
+                class Person
+                    middleName as
+                end class
+            `);
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)(diagnostics.length).to.be.greaterThan(0);
+            let cls = ast.statements[0];
+            (0, chai_config_spec_1.expect)(cls.fields[0].tokens.name.text).to.equal('middleName');
+            (0, testHelpers_spec_1.expectDiagnosticsIncludes)(diagnostics, DiagnosticMessages_1.DiagnosticMessages.expectedIdentifier('as'));
         });
         it('field access modifier defaults to undefined when omitted', () => {
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                     class Person
                         firstName as string
                     end class
                 `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics).to.be.lengthOf(0);
-            let cls = statements[0];
-            chai_1.expect(cls.fields[0].accessModifier).to.be.undefined;
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)(diagnostics).to.be.lengthOf(0);
+            let cls = ast.statements[0];
+            (0, chai_config_spec_1.expect)(cls.fields[0].tokens.accessModifier).to.be.undefined;
         });
     });
     describe('methods', () => {
         it('recognizes perfect syntax', () => {
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                     class Person
                         public function getName() as string
                             return "name"
                         end function
                     end class
                 `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics).to.be.lengthOf(0);
-            let theClass = statements[0];
-            chai_1.expect(theClass).to.be.instanceof(Statement_1.ClassStatement);
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)(diagnostics).to.be.lengthOf(0);
+            let theClass = ast.statements[0];
+            (0, chai_config_spec_1.expect)(theClass).to.be.instanceof(Statement_1.ClassStatement);
             let method = theClass.methods[0];
-            chai_1.expect(method.name.text).to.equal('getName');
-            chai_1.expect(method.accessModifier.text).to.equal('public');
-            chai_1.expect(method.func).to.exist;
+            (0, chai_config_spec_1.expect)(method.tokens.name.text).to.equal('getName');
+            (0, chai_config_spec_1.expect)(method.accessModifier.text).to.equal('public');
+            (0, chai_config_spec_1.expect)(method.func).to.exist;
         });
         it('supports omitting method return type', () => {
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                     class Person
                         public function getName()
                             return "name"
                         end function
                     end class
                 `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics).to.be.lengthOf(0);
-            let theClass = statements[0];
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)(diagnostics).to.be.lengthOf(0);
+            let theClass = ast.statements[0];
             let method = theClass.methods[0];
-            chai_1.expect(method.accessModifier.text).to.equal('public');
-            chai_1.expect(method.func).to.exist;
+            (0, chai_config_spec_1.expect)(method.accessModifier.text).to.equal('public');
+            (0, chai_config_spec_1.expect)(method.func).to.exist;
         });
         it('method access modifier is undefined when omitted', () => {
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                     class Person
                         function getName() as string
                             return "name"
                         end function
                     end class
                     `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics).to.be.lengthOf(0);
-            let cls = statements[0];
-            chai_1.expect(cls.methods[0].accessModifier).to.be.undefined;
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)(diagnostics).to.be.lengthOf(0);
+            let cls = ast.statements[0];
+            (0, chai_config_spec_1.expect)(cls.methods[0].accessModifier).to.be.undefined;
         });
-        it('supports primative field initializers', () => {
+        it('supports primitive field initializers', () => {
             var _a;
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                 class Person
                     name = "Bob"
                     age = 20
@@ -293,16 +322,16 @@ describe('parser class', () => {
                     end sub
                 end class
             `);
-            let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
-            let cls = statements[0];
-            chai_1.expect(cls.memberMap['name'].initialValue).to.exist;
-            chai_1.expect(cls.memberMap['age'].initialValue).to.exist;
-            chai_1.expect(cls.memberMap['isalive'].initialValue).to.exist;
-            chai_1.expect(cls.memberMap['callback'].initialValue).to.exist;
+            let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, chai_config_spec_1.expect)((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).not.to.exist;
+            let cls = ast.statements[0];
+            (0, chai_config_spec_1.expect)(cls.memberMap['name'].initialValue).to.exist;
+            (0, chai_config_spec_1.expect)(cls.memberMap['age'].initialValue).to.exist;
+            (0, chai_config_spec_1.expect)(cls.memberMap['isalive'].initialValue).to.exist;
+            (0, chai_config_spec_1.expect)(cls.memberMap['callback'].initialValue).to.exist;
         });
         it('detects missing function keyword', () => {
-            let { tokens } = lexer_1.Lexer.scan(`
+            let { tokens } = Lexer_1.Lexer.scan(`
                     class Person
                         public getName() as string
                             return "name"
@@ -310,8 +339,8 @@ describe('parser class', () => {
                     end class
                     `);
             let { diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect(diagnostics).to.have.lengthOf(1);
-            chai_1.expect(diagnostics[0].code).to.equal(DiagnosticMessages_1.DiagnosticMessages.missingCallableKeyword().code);
+            (0, chai_config_spec_1.expect)(diagnostics).to.have.lengthOf(1);
+            (0, chai_config_spec_1.expect)(diagnostics[0].code).to.equal(DiagnosticMessages_1.DiagnosticMessages.missingCallableKeyword().code);
         });
     });
     it('supports comments in various locations', () => {
@@ -326,11 +355,11 @@ describe('parser class', () => {
                 'comment
             end class 'comment
         `, { mode: Parser_1.ParseMode.BrighterScript });
-        chai_1.expect((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
+        (0, chai_config_spec_1.expect)((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
     });
     it('recognizes the "extends" keyword', () => {
         var _a;
-        let { tokens } = lexer_1.Lexer.scan(`
+        let { tokens } = Lexer_1.Lexer.scan(`
             class Person
                 public sub sayHi()
                     print "hi"
@@ -340,14 +369,14 @@ describe('parser class', () => {
             class Toddler extends Person
             end class
         `);
-        let { statements, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-        chai_1.expect((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
-        let stmt = statements[1];
-        chai_1.expect(stmt.extendsKeyword.text).to.equal('extends');
-        chai_1.expect(stmt.parentClassName.getName(Parser_1.ParseMode.BrighterScript)).to.equal('Person');
+        let { ast, diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
+        (0, chai_config_spec_1.expect)((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
+        let stmt = ast.statements[1];
+        (0, chai_config_spec_1.expect)(stmt.tokens.extends.text).to.equal('extends');
+        (0, chai_config_spec_1.expect)(stmt.parentClassName.getName()).to.equal('Person');
     });
     it('catches missing identifier after "extends" keyword', () => {
-        let { tokens } = lexer_1.Lexer.scan(`
+        let { tokens } = Lexer_1.Lexer.scan(`
             class Person
                 public sub sayHi()
                     print "hi"
@@ -358,22 +387,22 @@ describe('parser class', () => {
             end class
         `);
         let { diagnostics } = Parser_1.Parser.parse(tokens, { mode: Parser_1.ParseMode.BrighterScript });
-        chai_1.expect(diagnostics[0].code).to.equal(DiagnosticMessages_1.DiagnosticMessages.expectedIdentifierAfterKeyword('extends').code);
+        (0, chai_config_spec_1.expect)(diagnostics[0].code).to.equal(DiagnosticMessages_1.DiagnosticMessages.expectedIdentifier('extends').code);
     });
     describe('new keyword', () => {
         it('parses properly', () => {
             var _a;
-            let { statements, diagnostics } = Parser_1.Parser.parse(`
+            let { ast, diagnostics } = Parser_1.Parser.parse(`
                 sub main()
                     a = new Animal()
                 end sub
                 class Animal
                 end class
             `, { mode: Parser_1.ParseMode.BrighterScript });
-            chai_1.expect((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
-            let body = statements[0].func.body;
+            (0, chai_config_spec_1.expect)((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
+            let body = ast.statements[0].func.body;
             let stmt = body.statements[0];
-            chai_1.expect(stmt.value).to.be.instanceof(Expression_1.NewExpression);
+            (0, chai_config_spec_1.expect)(stmt.value).to.be.instanceof(Expression_1.NewExpression);
         });
         it('is allowed to be used as a local variable in brs files', () => {
             var _a;
@@ -383,7 +412,108 @@ describe('parser class', () => {
                   old = new
                 end sub
             `, { mode: Parser_1.ParseMode.BrightScript });
-            chai_1.expect((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
+            (0, chai_config_spec_1.expect)((_a = diagnostics[0]) === null || _a === void 0 ? void 0 : _a.message).to.not.exist;
+        });
+    });
+    describe('optional members', () => {
+        it('allows optional fields', () => {
+            let { ast, diagnostics } = Parser_1.Parser.parse(`
+                class HasOptional
+                    optional name as string
+                    optional height
+                end class
+            `, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(diagnostics);
+            (0, chai_config_spec_1.expect)(ast.statements.length).to.eq(1);
+            (0, chai_config_spec_1.expect)((0, reflection_1.isClassStatement)(ast.statements[0])).to.be.true;
+            const klass = ast.statements[0];
+            klass.fields.forEach(f => (0, chai_config_spec_1.expect)(f.isOptional).to.be.true);
+            const klassType = klass.getType({ flags: 2 /* SymbolTypeFlag.typetime */ });
+            // eslint-disable-next-line no-bitwise
+            klassType.getMemberTable().getAllSymbols(1 /* SymbolTypeFlag.runtime */).forEach(sym => (0, chai_config_spec_1.expect)(sym.flags & 4 /* SymbolTypeFlag.optional */).to.eq(4 /* SymbolTypeFlag.optional */));
+        });
+        it('allows fields named optional', () => {
+            let { ast, diagnostics } = Parser_1.Parser.parse(`
+                class IsJustOptional
+                    optional
+                    someThingElse
+                end class
+            `, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(diagnostics);
+            (0, chai_config_spec_1.expect)(ast.statements.length).to.eq(1);
+            (0, chai_config_spec_1.expect)((0, reflection_1.isClassStatement)(ast.statements[0])).to.be.true;
+            const klass = ast.statements[0];
+            klass.fields.forEach(f => (0, chai_config_spec_1.expect)(f.isOptional).to.be.false);
+            const klassType = klass.getType({ flags: 2 /* SymbolTypeFlag.typetime */ });
+            const klassMembers = klassType.getMemberTable().getAllSymbols(1 /* SymbolTypeFlag.runtime */);
+            (0, chai_config_spec_1.expect)(klassMembers.length).to.eq(2);
+            // eslint-disable-next-line no-bitwise
+            klassMembers.forEach(sym => (0, chai_config_spec_1.expect)(sym.flags & 4 /* SymbolTypeFlag.optional */).to.eq(0));
+        });
+        it('allows typed fields named optional', () => {
+            let { ast, diagnostics } = Parser_1.Parser.parse(`
+                class IsJustOptional
+                    optional as string
+                end class
+            `, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(diagnostics);
+            (0, chai_config_spec_1.expect)(ast.statements.length).to.eq(1);
+            (0, chai_config_spec_1.expect)((0, reflection_1.isClassStatement)(ast.statements[0])).to.be.true;
+            const klass = ast.statements[0];
+            klass.fields.forEach(f => (0, chai_config_spec_1.expect)(f.isOptional).to.be.false);
+            const klassType = klass.getType({ flags: 2 /* SymbolTypeFlag.typetime */ });
+            const klassMembers = klassType.getMemberTable().getAllSymbols(1 /* SymbolTypeFlag.runtime */);
+            (0, chai_config_spec_1.expect)(klassMembers.length).to.eq(1);
+            // eslint-disable-next-line no-bitwise
+            klassMembers.forEach(sym => (0, chai_config_spec_1.expect)(sym.flags & 4 /* SymbolTypeFlag.optional */).to.eq(0));
+        });
+        it('allows fields named optional that are also optional', () => {
+            let { ast, diagnostics } = Parser_1.Parser.parse(`
+                class IsJustOptional
+                    optional optional
+                end class
+            `, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(diagnostics);
+            (0, chai_config_spec_1.expect)(ast.statements.length).to.eq(1);
+            (0, chai_config_spec_1.expect)((0, reflection_1.isClassStatement)(ast.statements[0])).to.be.true;
+            const klass = ast.statements[0];
+            klass.fields.forEach(f => (0, chai_config_spec_1.expect)(f.isOptional).to.be.true);
+            const klassType = klass.getType({ flags: 2 /* SymbolTypeFlag.typetime */ });
+            const klassMembers = klassType.getMemberTable().getAllSymbols(1 /* SymbolTypeFlag.runtime */);
+            (0, chai_config_spec_1.expect)(klassMembers.length).to.eq(1);
+            // eslint-disable-next-line no-bitwise
+            klassMembers.forEach(sym => (0, chai_config_spec_1.expect)(sym.flags & 4 /* SymbolTypeFlag.optional */).to.eq(4 /* SymbolTypeFlag.optional */));
+        });
+        it('disallows optional methods', () => {
+            let { ast, diagnostics } = Parser_1.Parser.parse(`
+                class HasOptional
+
+                    optional function getValue() as boolean
+                        return false
+                    end function
+                end class
+            `, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, testHelpers_spec_1.expectDiagnosticsIncludes)(diagnostics, [
+                DiagnosticMessages_1.DiagnosticMessages.expectedNewlineOrColon().message
+            ]);
+            (0, chai_config_spec_1.expect)(ast.statements.length).to.eq(1);
+        });
+        it('allows fields named `as` that are also optional', () => {
+            let { ast, diagnostics } = Parser_1.Parser.parse(`
+                class IsJustOptional
+                    optional as
+                end class
+            `, { mode: Parser_1.ParseMode.BrighterScript });
+            (0, testHelpers_spec_1.expectZeroDiagnostics)(diagnostics);
+            (0, chai_config_spec_1.expect)(ast.statements.length).to.eq(1);
+            (0, chai_config_spec_1.expect)((0, reflection_1.isClassStatement)(ast.statements[0])).to.be.true;
+            const klass = ast.statements[0];
+            klass.fields.forEach(f => (0, chai_config_spec_1.expect)(f.isOptional).to.be.true);
+            const klassType = klass.getType({ flags: 2 /* SymbolTypeFlag.typetime */ });
+            const klassMembers = klassType.getMemberTable().getAllSymbols(1 /* SymbolTypeFlag.runtime */);
+            (0, chai_config_spec_1.expect)(klassMembers.length).to.eq(1);
+            // eslint-disable-next-line no-bitwise
+            klassMembers.forEach(sym => (0, chai_config_spec_1.expect)(sym.flags & 4 /* SymbolTypeFlag.optional */).to.eq(4 /* SymbolTypeFlag.optional */));
         });
     });
 });