brighterscript 1.0.0-alpha.22 → 1.0.0-alpha.24

package/dist/roku-types/index.d.ts

@@ -1463,6 +1463,7 @@ export declare const components: {
     roarray: {
         constructors: {
             params: {
+                default: any;
                 isRequired: boolean;
                 name: string;
                 type: string;
@@ -1553,14 +1554,22 @@ export declare const components: {
         url: string;
     };
     robitmap: {
-        constructors: {
+        constructors: ({
             params: {
+                default: any;
                 isRequired: boolean;
                 name: string;
                 type: string;
             }[];
             returnType: string;
-        }[];
+        } | {
+            params: {
+                isRequired: boolean;
+                name: string;
+                type: string;
+            }[];
+            returnType: string;
+        })[];
         description: string;
         events: any[];
         interfaces: {
@@ -1799,14 +1808,22 @@ export declare const components: {
         url: string;
     };
     rofontmetrics: {
-        constructors: {
+        constructors: ({
             params: {
+                default: any;
                 isRequired: boolean;
                 name: string;
                 type: string;
             }[];
             returnType: string;
-        }[];
+        } | {
+            params: {
+                isRequired: boolean;
+                name: string;
+                type: string;
+            }[];
+            returnType: string;
+        })[];
         deprecatedDescription: string;
         description: string;
         events: any[];
@@ -2214,6 +2231,7 @@ export declare const components: {
     roregion: {
         constructors: {
             params: {
+                default: any;
                 isRequired: boolean;
                 name: string;
                 type: string;
@@ -2244,14 +2262,22 @@ export declare const components: {
         url: string;
     };
     roregistrysection: {
-        constructors: {
+        constructors: ({
             params: {
+                default: any;
                 isRequired: boolean;
                 name: string;
                 type: string;
             }[];
             returnType: string;
-        }[];
+        } | {
+            params: {
+                isRequired: boolean;
+                name: string;
+                type: string;
+            }[];
+            returnType: string;
+        })[];
         description: string;
         events: any[];
         interfaces: {
@@ -2807,12 +2833,7 @@ export declare const interfaces: {
             name: string;
             url: string;
         }[];
-        methods: ({
-            description: string;
-            name: string;
-            params: any[];
-            returnType: string;
-        } | {
+        methods: {
             description: string;
             name: string;
             params: {
@@ -2822,8 +2843,8 @@ export declare const interfaces: {
                 name: string;
                 type: string;
             }[];
-            returnType?: undefined;
-        })[];
+            returnType: string;
+        }[];
         name: string;
         properties: any[];
         url: string;
@@ -2846,18 +2867,6 @@ export declare const interfaces: {
             }[];
             returnType: string;
             returnDescription?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                description: string;
-                isRequired: boolean;
-                name: string;
-                type: string;
-            }[];
-            returnType?: undefined;
-            returnDescription?: undefined;
         } | {
             description: string;
             name: string;
@@ -2886,8 +2895,8 @@ export declare const interfaces: {
             description: string;
             name: string;
             params: any[];
+            returnType: string;
             returnDescription?: undefined;
-            returnType?: undefined;
         } | {
             description: string;
             name: string;
@@ -2975,16 +2984,6 @@ export declare const interfaces: {
             }[];
             returnType: string;
             returnDescription?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnType?: undefined;
-            returnDescription?: undefined;
         })[];
         name: string;
         properties: any[];
@@ -3067,36 +3066,6 @@ export declare const interfaces: {
             }[];
             returnDescription: string;
             returnType: string;
-        } | {
-            description: string;
-            name: string;
-            params: ({
-                default: any;
-                description: string;
-                isRequired: boolean;
-                name: string;
-                type: string;
-            } | {
-                default: any;
-                isRequired: boolean;
-                name: string;
-                description?: undefined;
-                type?: undefined;
-            })[];
-            returnDescription: string;
-            returnType?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                description: string;
-                isRequired: boolean;
-                name: string;
-                type: string;
-            }[];
-            returnDescription?: undefined;
-            returnType?: undefined;
         } | {
             description: string;
             name: string;
@@ -3109,16 +3078,6 @@ export declare const interfaces: {
             }[];
             returnType: string;
             returnDescription?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnDescription?: undefined;
-            returnType?: undefined;
         })[];
         name: string;
         properties: any[];
@@ -3160,6 +3119,18 @@ export declare const interfaces: {
             }[];
             returnType: string;
             returnDescription?: undefined;
+        } | {
+            description: string;
+            name: string;
+            params: {
+                default: any;
+                description: string;
+                isRequired: boolean;
+                name: string;
+                type: string[];
+            }[];
+            returnType: string;
+            returnDescription?: undefined;
         })[];
         name: string;
         properties: any[];
@@ -3245,18 +3216,6 @@ export declare const interfaces: {
             }[];
             returnType: string;
             returnDescription?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                description: string;
-                isRequired: boolean;
-                name: string;
-                type: string;
-            }[];
-            returnDescription?: undefined;
-            returnType?: undefined;
         } | {
             description: string;
             name: string;
@@ -3361,18 +3320,6 @@ export declare const interfaces: {
             url: string;
         }[];
         methods: ({
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnDescription: string;
-            returnType?: undefined;
-            deprecatedDescription?: undefined;
-            isDeprecated?: undefined;
-        } | {
             description: string;
             name: string;
             params: {
@@ -3386,20 +3333,6 @@ export declare const interfaces: {
             returnType: string;
             deprecatedDescription?: undefined;
             isDeprecated?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                description: string;
-                isRequired: boolean;
-                name: string;
-                type: string;
-            }[];
-            returnDescription: string;
-            returnType?: undefined;
-            deprecatedDescription?: undefined;
-            isDeprecated?: undefined;
         } | {
             description: string;
             name: string;
@@ -3996,21 +3929,16 @@ export declare const interfaces: {
             url: string;
         }[];
         methods: ({
-            description: string;
-            name: string;
-            params: any[];
-            returnDescription: string;
-            returnType: string;
-        } | {
             description: string;
             name: string;
             params: {
                 default: any;
                 isRequired: boolean;
                 name: string;
+                type: string;
             }[];
             returnDescription: string;
-            returnType?: undefined;
+            returnType: string;
         } | {
             description: string;
             name: string;
@@ -4755,6 +4683,17 @@ export declare const interfaces: {
             }[];
             returnDescription: string;
             returnType: string;
+        } | {
+            description: string;
+            name: string;
+            params: {
+                default: any;
+                isRequired: boolean;
+                name: string;
+                type: string;
+            }[];
+            returnDescription: string;
+            returnType: string;
         })[];
         name: string;
         properties: any[];
@@ -4949,16 +4888,6 @@ export declare const interfaces: {
             url: string;
         }[];
         methods: ({
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnDescription: string;
-            returnType?: undefined;
-        } | {
             description: string;
             name: string;
             params: {
@@ -5046,18 +4975,6 @@ export declare const interfaces: {
             }[];
             returnDescription: string;
             returnType: string;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                description: string;
-                isRequired: boolean;
-                name: string;
-                type: string;
-            }[];
-            returnDescription: string;
-            returnType?: undefined;
         } | {
             description: string;
             name: string;
@@ -5115,12 +5032,14 @@ export declare const interfaces: {
             name: string;
             params: {
                 default: any;
+                description: string;
                 isRequired: boolean;
                 name: string;
+                type: string;
             }[];
             returnDescription: string;
+            returnType: string;
             description?: undefined;
-            returnType?: undefined;
         })[];
         name: string;
         properties: any[];
@@ -5638,26 +5557,6 @@ export declare const interfaces: {
             }[];
             returnDescription: string;
             returnType: string;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnDescription: string;
-            returnType?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnType?: undefined;
-            returnDescription?: undefined;
         })[];
         name: string;
         properties: any[];
@@ -5908,32 +5807,6 @@ export declare const interfaces: {
             returnDescription?: undefined;
             deprecatedDescription?: undefined;
             isDeprecated?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnDescription: string;
-            returnType?: undefined;
-            deprecatedDescription?: undefined;
-            isDeprecated?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                description: string;
-                isRequired: boolean;
-                name: string;
-                type: string;
-            }[];
-            returnType?: undefined;
-            returnDescription?: undefined;
-            deprecatedDescription?: undefined;
-            isDeprecated?: undefined;
         } | {
             deprecatedDescription: string;
             description: string;
@@ -5993,18 +5866,6 @@ export declare const interfaces: {
             returnType: string;
             description?: undefined;
             returnDescription?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnType?: undefined;
-            returnDescription?: undefined;
-            deprecatedDescription?: undefined;
-            isDeprecated?: undefined;
         })[];
         name: string;
         properties: any[];
@@ -6041,18 +5902,6 @@ export declare const interfaces: {
             returnDescription?: undefined;
             deprecatedDescription?: undefined;
             isDeprecated?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnType?: undefined;
-            returnDescription?: undefined;
-            deprecatedDescription?: undefined;
-            isDeprecated?: undefined;
         } | {
             description: string;
             name: string;
@@ -6067,20 +5916,6 @@ export declare const interfaces: {
             returnType: string;
             deprecatedDescription?: undefined;
             isDeprecated?: undefined;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                description: string;
-                isRequired: boolean;
-                name: string;
-                type: string;
-            }[];
-            returnType?: undefined;
-            returnDescription?: undefined;
-            deprecatedDescription?: undefined;
-            isDeprecated?: undefined;
         } | {
             deprecatedDescription: string;
             isDeprecated: boolean;
@@ -6129,16 +5964,6 @@ export declare const interfaces: {
             }[];
             returnDescription: string;
             returnType: string;
-        } | {
-            description: string;
-            name: string;
-            params: {
-                default: any;
-                isRequired: boolean;
-                name: string;
-            }[];
-            returnDescription: string;
-            returnType?: undefined;
         } | {
             name: string;
             params: {

package/dist/types/DynamicType.d.ts

@@ -2,6 +2,7 @@ import type { BscType } from './BscType';
 export declare class DynamicType implements BscType {
     typeText?: string;
     constructor(typeText?: string);
+    static readonly instance: DynamicType;
     isAssignableTo(targetType: BscType): boolean;
     /**
      * The dynamic type is convertible to everything.

package/dist/types/DynamicType.js

@@ -30,4 +30,5 @@ class DynamicType {
     }
 }
 exports.DynamicType = DynamicType;
+DynamicType.instance = new DynamicType();
 //# sourceMappingURL=DynamicType.js.map

package/dist/types/DynamicType.js.map

@@ -1 +1 @@
-{"version":3,"file":"DynamicType.js","sourceRoot":"","sources":["../../src/types/DynamicType.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AAGvD,MAAa,WAAW;IACpB,YACW,QAAiB;QAAjB,aAAQ,GAAR,QAAQ,CAAS;IACxB,CAAC;IAEE,cAAc,CAAC,UAAmB;QACrC,2EAA2E;QAC3E,OAAO,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,eAAe,CAAC,UAAmB;QACtC,2EAA2E;QAC3E,OAAO,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC;IAEM,QAAQ;;QACX,OAAO,MAAA,IAAI,CAAC,QAAQ,mCAAI,SAAS,CAAC;IACtC,CAAC;IAEM,YAAY;QACf,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAEM,MAAM,CAAC,UAAmB;QAC7B,OAAO,IAAA,0BAAa,EAAC,UAAU,CAAC,CAAC;IACrC,CAAC;CACJ;AA9BD,kCA8BC"}
+{"version":3,"file":"DynamicType.js","sourceRoot":"","sources":["../../src/types/DynamicType.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AAGvD,MAAa,WAAW;IACpB,YACW,QAAiB;QAAjB,aAAQ,GAAR,QAAQ,CAAS;IACxB,CAAC;IAIE,cAAc,CAAC,UAAmB;QACrC,2EAA2E;QAC3E,OAAO,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,eAAe,CAAC,UAAmB;QACtC,2EAA2E;QAC3E,OAAO,CAAC,CAAC,UAAU,CAAC;IACxB,CAAC;IAEM,QAAQ;;QACX,OAAO,MAAA,IAAI,CAAC,QAAQ,mCAAI,SAAS,CAAC;IACtC,CAAC;IAEM,YAAY;QACf,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAEM,MAAM,CAAC,UAAmB;QAC7B,OAAO,IAAA,0BAAa,EAAC,UAAU,CAAC,CAAC;IACrC,CAAC;;AA/BL,kCAgCC;AA3B0B,oBAAQ,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/util.d.ts

@@ -1,6 +1,6 @@
-import type { Diagnostic, Position, Range } from 'vscode-languageserver';
+import type { Diagnostic, Position, Range, Location } from 'vscode-languageserver';
 import type { BsConfig } from './BsConfig';
-import type { CallableContainer, BsDiagnostic, FileReference, CallableContainerMap, CompilerPlugin, ExpressionInfo, FunctionCall, CallableParam, TranspileResult } from './interfaces';
+import type { CallableContainer, BsDiagnostic, FileReference, CallableContainerMap, CompilerPlugin, ExpressionInfo, FunctionCall, CallableParam, TranspileResult, MinMax } from './interfaces';
 import { BooleanType } from './types/BooleanType';
 import { DoubleType } from './types/DoubleType';
 import { DynamicType } from './types/DynamicType';
@@ -11,13 +11,20 @@ import { LongIntegerType } from './types/LongIntegerType';
 import { StringType } from './types/StringType';
 import { VoidType } from './types/VoidType';
 import type { DottedGetExpression, Expression, NamespacedVariableNameExpression, VariableExpression } from './parser/Expression';
-import type { Locatable, Token } from './lexer/Token';
+import type { Identifier, Locatable, Token } from './lexer/Token';
 import { SourceNode } from 'source-map';
 import { SGAttribute } from './parser/SGTypes';
-import type { BscType } from './types/BscType';
+import type { BrsFile } from './files/BrsFile';
+import type { XmlFile } from './files/XmlFile';
 import { FunctionType } from './types/FunctionType';
+import type { BscType } from './types/BscType';
 export declare class Util {
     clearConsole(): void;
+    /**
+     * Returns the number of parent directories in the filPath
+     * @param filePath
+     */
+    getParentDirectoryCount(filePath: string | undefined): number;
     /**
      * Determine if the file exists
      * @param filePath
@@ -122,9 +129,25 @@ export declare class Util {
      */
     findBeginningVariableExpression(dottedGet: DottedGetExpression): VariableExpression | undefined;
     /**
-     * Does a touch b in any way?
+     * Do `a` and `b` overlap by at least one character. This returns false if they are at the edges. Here's some examples:
+     * ```
+     * | true | true | true | true | true | false | false | false | false |
+     * |------|------|------|------|------|-------|-------|-------|-------|
+     * | aa   |  aaa |  aaa | aaa  |  a   |  aa   |    aa | a     |     a |
+     * |  bbb | bb   |  bbb |  b   | bbb  |    bb |  bb   |     b | a     |
+     * ```
      */
     rangesIntersect(a: Range, b: Range): boolean;
+    /**
+     * Do `a` and `b` overlap by at least one character or touch at the edges
+     * ```
+     * | true | true | true | true | true | true  | true  | false | false |
+     * |------|------|------|------|------|-------|-------|-------|-------|
+     * | aa   |  aaa |  aaa | aaa  |  a   |  aa   |    aa | a     |     a |
+     * |  bbb | bb   |  bbb |  b   | bbb  |    bb |  bb   |     b | a     |
+     * ```
+     */
+    rangesIntersectOrTouch(a: Range, b: Range): boolean;
     /**
      * Test if `position` is in `range`. If the position is at the edges, will return true.
      * Adapted from core vscode
@@ -133,6 +156,13 @@ export declare class Util {
      */
     rangeContains(range: Range, position: Position): boolean;
     comparePositionToRange(position: Position, range: Range): 1 | -1 | 0;
+    /**
+    * Test if `insideRange` is wholly in `range` - the start and end of `insideRange` must be contained in `range`
+    * Adapted from core vscode
+    * @param range
+    * @param insideRange
+    */
+    rangeContainsRange(range: Range, insideRange: Range): boolean;
     /**
      * Parse an xml file and get back a javascript object containing its results
      * @param text
@@ -248,7 +278,11 @@ export declare class Util {
     splitIntoLines(string: string): string[];
     getTextForRange(string: string | string[], range: Range): string;
     /**
-     * Helper for creating `Range` objects. Prefer using this function because vscode-languageserver's `util.createRange()` is significantly slower
+     * Helper for creating `Location` objects. Prefer using this function because vscode-languageserver's `Location.create()` is significantly slower at scale
+     */
+    createLocation(uri: string, range: Range): Location;
+    /**
+     * Helper for creating `Range` objects. Prefer using this function because vscode-languageserver's `Range.create()` is significantly slower
      */
     createRange(startLine: number, startCharacter: number, endLine: number, endCharacter: number): Range;
     /**
@@ -286,7 +320,6 @@ export declare class Util {
      * Load and return the list of plugins
      */
     loadPlugins(cwd: string, pathOrModules: string[], onError?: (pathOrModule: string, err: Error) => void): CompilerPlugin[];
-    resolveRequire(cwd: string, pathOrModule: string): any;
     /**
      * Gathers expressions, variables, and unique names from an expression.
      * This is mostly used for the ternary expression
@@ -320,14 +353,16 @@ export declare class Util {
      */
     copyBslibToStaging(stagingDir: string): Promise<void>;
     /**
-     * Given a Diagnostic or BsDiagnostic, return a copy of the diagnostic
+     * Given a Diagnostic or BsDiagnostic, return a deep clone of the diagnostic.
+     * @param diagnostic the diagnostic to clone
+     * @param relatedInformationFallbackLocation a default location to use for all `relatedInformation` entries that are missing a location
      */
-    toDiagnostic(diagnostic: Diagnostic | BsDiagnostic): {
+    toDiagnostic(diagnostic: Diagnostic | BsDiagnostic, fileUri: string): {
         severity: import("vscode-languageserver-types").DiagnosticSeverity;
         range: Range;
         message: string;
         relatedInformation: {
-            location: import("vscode-languageserver-types").Location;
+            location: Location;
             message: string;
         }[];
         code: string | number;
@@ -354,10 +389,15 @@ export declare class Util {
      * @return an array with callable containers - could be empty if nothing was found
      */
     getCallableContainersByName(callablesByLowerName: CallableContainerMap, expCall: FunctionCall): CallableContainer[];
+    /**
+    * Get the first locatable item found at the specified position
+    * @param position
+    */
+    getFirstLocatableAt(locatables: Locatable[], position: Position): Locatable;
     /**
      * Sort an array of objects that have a Range
      */
-    sortByRange(locatables: Locatable[]): Locatable[];
+    sortByRange<T extends Locatable>(locatables: T[]): T[];
     /**
      * Split the given text and return ranges for each chunk.
      * Only works for single-line strings
@@ -379,7 +419,11 @@ export declare class Util {
      * @param expression
      * @returns an array of the parts of the dotted get. If not fully a dotted get, then returns undefined
      */
-    getAllDottedGetParts(expression: Expression): string[] | undefined;
+    getAllDottedGetParts(expression: Expression): Identifier[] | undefined;
+    /**
+     * Break an expression into each part.
+     */
+    splitExpression(expression: Expression): Expression[];
     /**
      * Returns an integer if valid, or undefined. Eliminates checking for NaN
      */
@@ -388,6 +432,7 @@ export declare class Util {
      * Converts a range to a string in the format 1:2-3:4
      */
     rangeToString(range: Range): string;
+    validateTooDeepFile(file: (BrsFile | XmlFile)): void;
 }
 /**
  * A tagged template literal function for standardizing the path. This has to be defined as standalone function since it's a tagged template literal function,
@@ -396,8 +441,4 @@ export declare class Util {
 export declare function standardizePath(stringParts: any, ...expressions: any[]): string;
 export declare let util: Util;
 export default util;
-export interface MinMax {
-    min: number;
-    max: number;
-}
 export declare const MAX_PARAM_COUNT = 32;