brighterscript 1.0.0-alpha.27 → 1.0.0-alpha.28

package/dist/parser/Statement.d.ts

@@ -6,9 +6,8 @@ import type { Range } from 'vscode-languageserver';
 import type { BrsTranspileState } from './BrsTranspileState';
 import { ParseMode } from './Parser';
 import type { WalkVisitor, WalkOptions } from '../astUtils/visitors';
-import type { GetTypeOptions, TranspileResult, TypedefProvider } from '../interfaces';
-import type { SourceNode } from 'source-map';
-import type { TranspileState } from './TranspileState';
+import { type GetTypeOptions, type TranspileResult, type TypedefProvider } from '../interfaces';
+import type { BscType } from '../types/BscType';
 import { SymbolTable } from '../SymbolTable';
 import type { Expression } from './AstNode';
 import { AstNodeKind } from './AstNode';
@@ -17,7 +16,6 @@ import { ClassType } from '../types/ClassType';
 import { EnumMemberType, EnumType } from '../types/EnumType';
 import { NamespaceType } from '../types/NamespaceType';
 import { InterfaceType } from '../types/InterfaceType';
-import type { BscType } from '../types/BscType';
 import { TypedFunctionType } from '../types/TypedFunctionType';
 export declare class EmptyStatement extends Statement {
     constructor(options?: {
@@ -26,7 +24,7 @@ export declare class EmptyStatement extends Statement {
     /**
      * Create a negative range to indicate this is an interpolated location
      */
-    readonly range: Range;
+    readonly range?: Range;
     readonly kind = AstNodeKind.EmptyStatement;
     transpile(state: BrsTranspileState): any[];
     walk(visitor: WalkVisitor, options: WalkOptions): void;
@@ -43,7 +41,7 @@ export declare class Body extends Statement implements TypedefProvider {
     readonly symbolTable: SymbolTable;
     get range(): Range;
     transpile(state: BrsTranspileState): TranspileResult;
-    getTypedef(state: BrsTranspileState): any[];
+    getTypedef(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
 }
 export declare class AssignmentStatement extends Statement {
@@ -60,22 +58,23 @@ export declare class AssignmentStatement extends Statement {
         readonly as?: Token;
     };
     readonly value: Expression;
-    readonly typeExpression: TypeExpression;
+    readonly typeExpression?: TypeExpression;
     readonly kind = AstNodeKind.AssignmentStatement;
-    readonly range: Range;
+    readonly range: Range | undefined;
     transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
     getType(options: GetTypeOptions): BscType;
+    getLeadingTrivia(): Token[];
 }
 export declare class Block extends Statement {
     constructor(options: {
         statements: Statement[];
-        startingRange: Range;
+        startingRange?: Range;
     });
     readonly statements: Statement[];
-    readonly startingRange: Range;
+    readonly startingRange?: Range;
     readonly kind = AstNodeKind.Block;
-    readonly range: Range;
+    readonly range: Range | undefined;
     transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
 }
@@ -85,23 +84,10 @@ export declare class ExpressionStatement extends Statement {
     });
     readonly expression: Expression;
     readonly kind = AstNodeKind.ExpressionStatement;
-    readonly range: Range;
+    readonly range: Range | undefined;
     transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
-}
-export declare class CommentStatement extends Statement implements Expression, TypedefProvider {
-    constructor(options: {
-        comments: Token[];
-    });
-    readonly tokens: {
-        readonly comments: Token[];
-    };
-    readonly kind = AstNodeKind.CommentStatement;
-    readonly range: Range;
-    get text(): string;
-    transpile(state: BrsTranspileState): any[];
-    getTypedef(state: TranspileState): any[];
-    walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class ExitForStatement extends Statement {
     constructor(options?: {
@@ -111,9 +97,10 @@ export declare class ExitForStatement extends Statement {
         readonly exitFor?: Token;
     };
     readonly kind = AstNodeKind.ExitForStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): (string | SourceNode)[];
+    readonly range?: Range;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class ExitWhileStatement extends Statement {
     constructor(options?: {
@@ -123,9 +110,10 @@ export declare class ExitWhileStatement extends Statement {
         readonly exitWhile?: Token;
     };
     readonly kind = AstNodeKind.ExitWhileStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): (string | SourceNode)[];
+    readonly range?: Range;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class FunctionStatement extends Statement implements TypedefProvider {
     constructor(options: {
@@ -137,14 +125,14 @@ export declare class FunctionStatement extends Statement implements TypedefProvi
     };
     readonly func: FunctionExpression;
     readonly kind: AstNodeKind;
-    readonly range: Range;
+    readonly range: Range | undefined;
     /**
      * Get the name of this expression based on the parse mode
      */
     getName(parseMode: ParseMode): string;
     getLeadingTrivia(): Token[];
-    transpile(state: BrsTranspileState): any[];
-    getTypedef(state: BrsTranspileState): any[];
+    transpile(state: BrsTranspileState): TranspileResult;
+    getTypedef(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
     getType(options: GetTypeOptions): TypedFunctionType;
 }
@@ -170,9 +158,10 @@ export declare class IfStatement extends Statement {
     readonly elseBranch?: IfStatement | Block;
     readonly isInline?: boolean;
     readonly kind = AstNodeKind.IfStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): any[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class IncrementStatement extends Statement {
     constructor(options: {
@@ -184,9 +173,10 @@ export declare class IncrementStatement extends Statement {
         readonly operator: Token;
     };
     readonly kind = AstNodeKind.IncrementStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): (string | SourceNode)[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): (string | import("source-map").SourceNode | TranspileResult)[];
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 /** Used to indent the current `print` position to the next 16-character-width output zone. */
 export interface PrintSeparatorTab extends Token {
@@ -215,9 +205,10 @@ export declare class PrintStatement extends Statement {
     };
     readonly expressions: Array<Expression | PrintSeparatorTab | PrintSeparatorSpace>;
     readonly kind = AstNodeKind.PrintStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): (string | SourceNode)[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class DimStatement extends Statement {
     constructor(options: {
@@ -235,10 +226,11 @@ export declare class DimStatement extends Statement {
     };
     readonly dimensions: Expression[];
     readonly kind = AstNodeKind.DimStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): (string | SourceNode)[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
     getType(options: GetTypeOptions): BscType;
+    getLeadingTrivia(): Token[];
 }
 export declare class GotoStatement extends Statement {
     constructor(options: {
@@ -250,9 +242,10 @@ export declare class GotoStatement extends Statement {
         readonly label: Token;
     };
     readonly kind = AstNodeKind.GotoStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): (string | SourceNode)[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): (string | TranspileResult)[];
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class LabelStatement extends Statement {
     constructor(options: {
@@ -264,9 +257,9 @@ export declare class LabelStatement extends Statement {
         readonly colon: Token;
     };
     readonly kind = AstNodeKind.LabelStatement;
-    readonly range: Range;
+    readonly range: Range | undefined;
     getLeadingTrivia(): Token[];
-    transpile(state: BrsTranspileState): SourceNode[];
+    transpile(state: BrsTranspileState): TranspileResult[];
     walk(visitor: WalkVisitor, options: WalkOptions): void;
 }
 export declare class ReturnStatement extends Statement {
@@ -279,9 +272,10 @@ export declare class ReturnStatement extends Statement {
     };
     readonly value?: Expression;
     readonly kind = AstNodeKind.ReturnStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): any[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class EndStatement extends Statement {
     constructor(options?: {
@@ -292,8 +286,9 @@ export declare class EndStatement extends Statement {
     };
     readonly kind = AstNodeKind.EndStatement;
     readonly range: Range;
-    transpile(state: BrsTranspileState): SourceNode[];
+    transpile(state: BrsTranspileState): TranspileResult[];
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class StopStatement extends Statement {
     constructor(options?: {
@@ -304,8 +299,9 @@ export declare class StopStatement extends Statement {
     };
     readonly kind = AstNodeKind.StopStatement;
     readonly range: Range;
-    transpile(state: BrsTranspileState): SourceNode[];
+    transpile(state: BrsTranspileState): TranspileResult[];
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class ForStatement extends Statement {
     constructor(options: {
@@ -329,9 +325,10 @@ export declare class ForStatement extends Statement {
     readonly body: Block;
     readonly increment?: Expression;
     readonly kind = AstNodeKind.ForStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): any[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class ForEachStatement extends Statement {
     constructor(options: {
@@ -351,9 +348,11 @@ export declare class ForEachStatement extends Statement {
     readonly body: Block;
     readonly target: Expression;
     readonly kind = AstNodeKind.ForEachStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): any[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getType(options: GetTypeOptions): BscType;
+    getLeadingTrivia(): Token[];
 }
 export declare class WhileStatement extends Statement {
     constructor(options: {
@@ -369,9 +368,10 @@ export declare class WhileStatement extends Statement {
     readonly condition: Expression;
     readonly body: Block;
     readonly kind = AstNodeKind.WhileStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): any[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class DottedSetStatement extends Statement {
     constructor(options: {
@@ -387,10 +387,11 @@ export declare class DottedSetStatement extends Statement {
     readonly obj: Expression;
     readonly value: Expression;
     readonly kind = AstNodeKind.DottedSetStatement;
-    readonly range: Range;
+    readonly range: Range | undefined;
     transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
     getType(options: GetTypeOptions): BscType;
+    getLeadingTrivia(): Token[];
 }
 export declare class IndexedSetStatement extends Statement {
     constructor(options: {
@@ -408,9 +409,10 @@ export declare class IndexedSetStatement extends Statement {
     readonly indexes: Expression[];
     readonly value: Expression;
     readonly kind = AstNodeKind.IndexedSetStatement;
-    readonly range: Range;
+    readonly range: Range | undefined;
     transpile(state: BrsTranspileState): any[];
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class LibraryStatement extends Statement implements TypedefProvider {
     constructor(options: {
@@ -422,10 +424,11 @@ export declare class LibraryStatement extends Statement implements TypedefProvid
         readonly filePath?: Token;
     };
     readonly kind = AstNodeKind.LibraryStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): any[];
-    getTypedef(state: BrsTranspileState): any[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
+    getTypedef(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class NamespaceStatement extends Statement implements TypedefProvider {
     constructor(options: {
@@ -452,14 +455,14 @@ export declare class NamespaceStatement extends Statement implements TypedefProv
     getLeadingTrivia(): Token[];
     getNameParts(): Identifier[];
     transpile(state: BrsTranspileState): TranspileResult;
-    getTypedef(state: BrsTranspileState): string[];
+    getTypedef(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
     getType(options: GetTypeOptions): NamespaceType;
 }
 export declare class ImportStatement extends Statement implements TypedefProvider {
     constructor(options: {
         import?: Token;
-        path: Token;
+        path?: Token;
     });
     readonly tokens: {
         readonly import?: Token;
@@ -468,12 +471,13 @@ export declare class ImportStatement extends Statement implements TypedefProvide
     readonly kind = AstNodeKind.ImportStatement;
     readonly range: Range;
     readonly filePath: string;
-    transpile(state: BrsTranspileState): (string | SourceNode)[];
+    transpile(state: BrsTranspileState): (string | TranspileResult)[];
     /**
      * Get the typedef for this statement
      */
     getTypedef(state: BrsTranspileState): string[];
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class InterfaceStatement extends Statement implements TypedefProvider {
     constructor(options: {
@@ -493,7 +497,7 @@ export declare class InterfaceStatement extends Statement implements TypedefProv
         readonly extends?: Token;
         readonly endInterface?: Token;
     };
-    readonly range: Range;
+    readonly range: Range | undefined;
     get fields(): InterfaceFieldStatement[];
     get methods(): InterfaceMethodStatement[];
     hasParentInterface(): boolean;
@@ -525,7 +529,7 @@ export declare class InterfaceFieldStatement extends Statement implements Typede
     });
     readonly kind = AstNodeKind.InterfaceFieldStatement;
     readonly typeExpression?: TypeExpression;
-    readonly range: Range;
+    readonly range: Range | undefined;
     readonly tokens: {
         readonly name: Identifier;
         readonly as: Token;
@@ -535,7 +539,7 @@ export declare class InterfaceFieldStatement extends Statement implements Typede
     get name(): string;
     get isOptional(): boolean;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
-    getTypedef(state: BrsTranspileState): (string | SourceNode)[];
+    getTypedef(state: BrsTranspileState): TranspileResult;
     getType(options: GetTypeOptions): BscType;
 }
 export declare class InterfaceMethodStatement extends Statement implements TypedefProvider {
@@ -601,8 +605,8 @@ export declare class ClassStatement extends Statement implements TypedefProvider
     readonly memberMap: Record<string, MemberStatement>;
     readonly methods: MethodStatement[];
     readonly fields: FieldStatement[];
-    readonly range: Range;
-    transpile(state: BrsTranspileState): any[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
     getTypedef(state: BrsTranspileState): TranspileResult;
     /**
      * Find the parent index for this class's parent.
@@ -655,14 +659,14 @@ export declare class MethodStatement extends FunctionStatement {
         readonly override?: Token;
     };
     get accessModifier(): Token;
-    readonly range: Range;
+    readonly range: Range | undefined;
     /**
      * Get the name of this method.
      */
     getName(parseMode: ParseMode): string;
     getLeadingTrivia(): Token[];
-    transpile(state: BrsTranspileState): any[];
-    getTypedef(state: BrsTranspileState): (string | SourceNode)[];
+    transpile(state: BrsTranspileState): TranspileResult;
+    getTypedef(state: BrsTranspileState): TranspileResult;
     /**
      * All child classes must call the parent constructor. The type checker will warn users when they don't call it in their own class,
      * but we still need to call it even if they have omitted it. This injects the super call if it's missing
@@ -699,7 +703,7 @@ export declare class FieldStatement extends Statement implements TypedefProvider
      * Defaults to `DynamicType`
      */
     getType(options: GetTypeOptions): BscType;
-    readonly range: Range;
+    readonly range: Range | undefined;
     getLeadingTrivia(): Token[];
     get isOptional(): boolean;
     transpile(state: BrsTranspileState): TranspileResult;
@@ -721,9 +725,10 @@ export declare class TryCatchStatement extends Statement {
     readonly tryBranch: Block;
     readonly catchStatement: CatchStatement;
     readonly kind = AstNodeKind.TryCatchStatement;
-    readonly range: Range;
+    readonly range: Range | undefined;
     transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class CatchStatement extends Statement {
     constructor(options?: {
@@ -737,9 +742,10 @@ export declare class CatchStatement extends Statement {
     };
     readonly catchBranch?: Block;
     readonly kind = AstNodeKind.CatchStatement;
-    readonly range: Range;
+    readonly range: Range | undefined;
     transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class ThrowStatement extends Statement {
     constructor(options?: {
@@ -751,25 +757,26 @@ export declare class ThrowStatement extends Statement {
     };
     readonly expression?: Expression;
     readonly kind = AstNodeKind.ThrowStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): (string | SourceNode)[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }
 export declare class EnumStatement extends Statement implements TypedefProvider {
     constructor(options: {
         enum?: Token;
         name: Identifier;
         endEnum?: Token;
-        body: Array<EnumMemberStatement | CommentStatement>;
+        body: Array<EnumMemberStatement>;
     });
     readonly tokens: {
         readonly enum?: Token;
         readonly name: Identifier;
         readonly endEnum?: Token;
     };
-    readonly body: Array<EnumMemberStatement | CommentStatement>;
+    readonly body: Array<EnumMemberStatement>;
     readonly kind = AstNodeKind.EnumStatement;
-    get range(): Range;
+    get range(): Range | undefined;
     getMembers(): EnumMemberStatement[];
     getLeadingTrivia(): Token[];
     /**
@@ -810,7 +817,7 @@ export declare class EnumMemberStatement extends Statement implements TypedefPro
     get name(): string;
     getLeadingTrivia(): Token[];
     transpile(state: BrsTranspileState): TranspileResult;
-    getTypedef(state: BrsTranspileState): (string | SourceNode)[];
+    getTypedef(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
     getType(options: GetTypeOptions): EnumMemberType;
 }
@@ -828,7 +835,7 @@ export declare class ConstStatement extends Statement implements TypedefProvider
     };
     readonly value: Expression;
     readonly kind = AstNodeKind.ConstStatement;
-    readonly range: Range;
+    readonly range: Range | undefined;
     get name(): string;
     getLeadingTrivia(): Token[];
     /**
@@ -836,7 +843,7 @@ export declare class ConstStatement extends Statement implements TypedefProvider
      */
     get fullName(): string;
     transpile(state: BrsTranspileState): TranspileResult;
-    getTypedef(state: BrsTranspileState): (string | SourceNode)[];
+    getTypedef(state: BrsTranspileState): TranspileResult;
     walk(visitor: WalkVisitor, options: WalkOptions): void;
     getType(options: GetTypeOptions): BscType;
 }
@@ -850,7 +857,8 @@ export declare class ContinueStatement extends Statement {
         readonly loopType: Token;
     };
     readonly kind = AstNodeKind.ContinueStatement;
-    readonly range: Range;
-    transpile(state: BrsTranspileState): (string | SourceNode)[];
+    readonly range: Range | undefined;
+    transpile(state: BrsTranspileState): (string | import("source-map").SourceNode)[];
     walk(visitor: WalkVisitor, options: WalkOptions): void;
+    getLeadingTrivia(): Token[];
 }