brighterscript 1.0.0-alpha.27 → 1.0.0-alpha.29

package/dist/Scope.d.ts

@@ -1,13 +1,12 @@
-import type { CallableContainer, BsDiagnosticWithOrigin, CallableContainerMap, FileLink, Callable, NamespaceContainer, ScopeValidationOptions, BsDiagnostic } from './interfaces';
+import type { CallableContainer, BsDiagnosticWithOrigin, FileReference, FileLink, Callable, NamespaceContainer, ScopeValidationOptions, BsDiagnostic } from './interfaces';
 import type { Program } from './Program';
-import type { NamespaceStatement, ClassStatement, EnumStatement, InterfaceStatement, EnumMemberStatement, ConstStatement } from './parser/Statement';
+import { type NamespaceStatement, type ClassStatement, type EnumStatement, type InterfaceStatement, type EnumMemberStatement, type ConstStatement } from './parser/Statement';
 import { Cache } from './Cache';
 import type { BrsFile } from './files/BrsFile';
 import type { DependencyGraph, DependencyChangedEvent } from './DependencyGraph';
 import { SymbolTable } from './SymbolTable';
 import type { BscFile } from './files/BscFile';
 import type { AstNode, Statement } from './parser/AstNode';
-import type { Token } from './lexer/Token';
 /**
  * A class to keep track of all declarations within a given scope (like source scope, component scope)
  */
@@ -37,6 +36,10 @@ export declare class Scope {
      * Get a NamespaceContainer by its name, looking for a fully qualified version first, then global version next if not found
      */
     getNamespacesWithRoot(rootName: string, containingNamespace?: string): NamespaceContainer[];
+    /**
+     * Get a NamespaceContainer by its name, looking for a fully qualified version first, then global version next if not found
+     */
+    getFirstNamespaceWithRoot(rootName: string, containingNamespace?: string): NamespaceContainer;
     /**
      * Get the class with the specified name.
      * @param className - The class name, including the namespace of the class if possible
@@ -55,6 +58,8 @@ export declare class Scope {
      * @param containingNamespace - The namespace used to resolve relative enum names. (i.e. the namespace around the current statement trying to find an enum)
      */
     getEnum(enumName: string, containingNamespace?: string): EnumStatement;
+    private useFileCachesForFileLinkLookups;
+    private getFileLinkFromFileMap;
     /**
      * Get a class and its containing file by the class name
      * @param className - The class name, including the namespace of the class if possible
@@ -85,7 +90,7 @@ export declare class Scope {
      * @param containingNamespace - The namespace used to resolve relative constant names. (i.e. the namespace around the current statement trying to find a constant)
      */
     getConstFileLink(constName: string, containingNamespace?: string): FileLink<ConstStatement>;
-    getAllFileLinks(name: string, containingNamespace?: string): FileLink<Statement>[];
+    getAllFileLinks(name: string, containingNamespace?: string, includeNamespaces?: boolean, includeNameShadowsOutsideNamespace?: boolean): FileLink<Statement>[];
     /**
      * Get a map of all enums by their member name.
      * The keys are lower-case fully-qualified paths to the enum and its member. For example:
@@ -172,6 +177,10 @@ export declare class Scope {
      * Includes files from this scope and all ancestor scopes
      */
     getAllFiles(): BscFile[];
+    /**
+     * Gets a list of all files in this scope, but not imported files, and not from ancestor scopes
+     */
+    getImmediateFiles(): BscFile[];
     /**
      * Get the list of errors for this scope. It's calculated on the fly, so call this sparingly.
      */
@@ -187,10 +196,15 @@ export declare class Scope {
      */
     getCallableByName(name: string): Callable;
     getCallableMap(): Map<string, Callable>;
+    getCallableContainerMap(): import("./interfaces").CallableContainerMap;
     /**
      * Iterate over Brs files not shadowed by typedefs
      */
     enumerateBrsFiles(callback: (file: BrsFile) => void): void;
+    /**
+     * Iterate over Brs files not shadowed by typedefs
+     */
+    enumerateBrsFilesWithBreak(callback: (file: BrsFile) => boolean): void;
     /**
      * Call a function for each file directly included in this scope (excluding files found only in parent scopes).
      */
@@ -209,8 +223,11 @@ export declare class Scope {
     getAllNamespaceStatements(): NamespaceStatement[];
     protected logDebug(...args: any[]): void;
     private _debugLogComponentName;
-    validate(validationOptions?: ScopeValidationOptions): void;
-    protected _validate(callableContainerMap: CallableContainerMap): void;
+    validationMetrics: {
+        linkTime: number;
+        validationTime: number;
+    };
+    validate(validationOptions?: ScopeValidationOptions): boolean;
     clearAstSegmentDiagnostics(astSegment: AstNode): void;
     clearAstSegmentDiagnosticsByFile(file: BscFile): void;
     clearScopeLevelDiagnostics(): void;
@@ -224,6 +241,8 @@ export declare class Scope {
      */
     private linkSymbolTableDisposables;
     private symbolsAddedDuringLinking;
+    get allNamespaceTypeTable(): SymbolTable;
+    private _allNamespaceTypeTable;
     /**
      * Builds the current symbol table for the scope, by merging the tables for all the files in this scope.
      * Also links all file symbols tables to this new table
@@ -245,34 +264,14 @@ export declare class Scope {
      */
     linkSymbolTable(): void;
     unlinkSymbolTable(): void;
-    private detectVariableNamespaceCollisions;
-    /**
-     * Find various function collisions
-     */
-    private diagnosticDetectFunctionCollisions;
-    private detectNameCollisions;
-    validateNameCollision(file: BrsFile, node: AstNode, nameIdentifier: Token): void;
-    private validateClasses;
-    /**
-     * Detect local variables (function scope) that have the same name as scope calls
-     */
-    private diagnosticDetectShadowedLocalVars;
-    /**
-     * Create diagnostics for any duplicate function declarations
-     */
-    private diagnosticFindDuplicateFunctionDeclarations;
     /**
      * Get the list of all script imports for this scope
      */
-    private getOwnScriptImports;
-    /**
-     * Verify that all of the scripts imported by each file in this scope actually exist
-     */
-    private diagnosticValidateScriptImportPaths;
+    getOwnScriptImports(): FileReference[];
     /**
      * Find the file with the specified relative path
      */
-    protected getFileByRelativePath(relativePath: string): BscFile;
+    getFileByRelativePath(relativePath: string): BscFile;
     /**
      * Determine if this file is included in this scope (excluding parent scopes)
      */