brighterscript 0.66.0-alpha.6 → 0.66.0-alpha.8

package/dist/Scope.d.ts

@@ -1,14 +1,14 @@
-import type { Position, Range, Location } from 'vscode-languageserver';
-import type { CallableContainer, BsDiagnostic, BscFile, CallableContainerMap, FileLink, Callable } from './interfaces';
+import type { Position, Location } from 'vscode-languageserver';
+import { type CallableContainer, type BsDiagnosticWithOrigin, type CallableContainerMap, type FileLink, type Callable, type NamespaceContainer, type ScopeValidationOptions, type BsDiagnostic } from './interfaces';
 import type { Program } from './Program';
-import type { NamespaceStatement, FunctionStatement, ClassStatement, EnumStatement, InterfaceStatement, EnumMemberStatement, ConstStatement } from './parser/Statement';
-import type { NewExpression } from './parser/Expression';
+import type { NamespaceStatement, ClassStatement, EnumStatement, InterfaceStatement, EnumMemberStatement, ConstStatement } from './parser/Statement';
+import { type NewExpression } from './parser/Expression';
 import { Cache } from './Cache';
 import type { BrsFile } from './files/BrsFile';
 import type { DependencyGraph, DependencyChangedEvent } from './DependencyGraph';
 import { SymbolTable } from './SymbolTable';
-import type { Statement } from './parser/AstNode';
-import type { Identifier } from './lexer/Token';
+import type { File } from './files/File';
+import type { AstNode } from './parser/AstNode';
 /**
  * A class to keep track of all declarations within a given scope (like source scope, component scope)
  */
@@ -129,7 +129,7 @@ export declare class Scope {
     /**
      * The list of diagnostics found specifically for this scope. Individual file diagnostics are stored on the files themselves.
      */
-    protected diagnostics: BsDiagnostic[];
+    protected diagnostics: BsDiagnosticWithOrigin[];
     protected onDependenciesChanged(event: DependencyChangedEvent): void;
     /**
      * Clean up all event handles
@@ -154,26 +154,25 @@ export declare class Scope {
     attachDependencyGraph(dependencyGraph: DependencyGraph): void;
     /**
      * Get the file from this scope with the given path.
-     * @param filePath can be a srcPath or pkgPath
+     * @param filePath can be a srcPath or destPath
      * @param normalizePath should this function repair and standardize the path? Passing false should have a performance boost if you can guarantee your path is already sanitized
      */
-    getFile<TFile extends BscFile>(filePath: string, normalizePath?: boolean): TFile;
+    getFile<TFile extends File>(filePath: string, normalizePath?: boolean): TFile;
     /**
      * Get the list of files referenced by this scope that are actually loaded in the program.
      * Excludes files from ancestor scopes
      */
-    getOwnFiles(): BscFile[];
+    getOwnFiles(): File[];
     /**
      * Get the list of files referenced by this scope that are actually loaded in the program.
      * Includes files from this scope and all ancestor scopes
      */
-    getAllFiles(): BscFile[];
+    getAllFiles(): File[];
     /**
-     * Get the list of errors for this scope. It's calculated on the fly, so
-     * call this sparingly.
+     * Get the list of errors for this scope. It's calculated on the fly, so call this sparingly.
      */
     getDiagnostics(): BsDiagnostic[];
-    addDiagnostics(diagnostics: BsDiagnostic[]): void;
+    addDiagnostics(diagnostics: BsDiagnosticWithOrigin[]): void;
     /**
      * Get the list of callables available in this scope (either declared in this scope or in a parent scope)
      */
@@ -191,7 +190,7 @@ export declare class Scope {
     /**
      * Call a function for each file directly included in this scope (excluding files found only in parent scopes).
      */
-    enumerateOwnFiles(callback: (file: BscFile) => void): void;
+    enumerateOwnFiles(callback: (file: File) => void): void;
     /**
      * Get the list of callables explicitly defined in files in this scope.
      * This excludes ancestor callables
@@ -200,12 +199,17 @@ export declare class Scope {
     /**
      * Builds a tree of namespace objects
      */
-    buildNamespaceLookup(): Map<string, NamespaceContainer>;
+    buildNamespaceLookup(options?: {
+        okToCache?: boolean;
+    }): Map<string, NamespaceContainer>;
     getAllNamespaceStatements(): NamespaceStatement[];
     protected logDebug(...args: any[]): void;
     private _debugLogComponentName;
-    validate(force?: boolean): void;
+    validate(validationOptions?: ScopeValidationOptions): void;
     protected _validate(callableContainerMap: CallableContainerMap): void;
+    clearAstSegmentDiagnostics(astSegment: AstNode): void;
+    clearAstSegmentDiagnosticsByFile(file: File): void;
+    clearScopeLevelDiagnostics(): void;
     /**
      * Mark this scope as invalid, which means its `validate()` function needs to be called again before use.
      */
@@ -215,6 +219,7 @@ export declare class Scope {
      * A list of functions that will be called whenever `unlinkSymbolTable` is called
      */
     private linkSymbolTableDisposables;
+    private symbolsAddedDuringLinking;
     /**
      * 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
@@ -262,15 +267,15 @@ export declare class Scope {
     /**
      * Find the file with the specified relative path
      */
-    protected getFileByRelativePath(relativePath: string): BscFile;
+    protected getFileByRelativePath(relativePath: string): File;
     /**
      * Determine if this file is included in this scope (excluding parent scopes)
      */
-    hasFile(file: BscFile): boolean;
+    hasFile(file: File): boolean;
     /**
      * Get the definition (where was this thing first defined) of the symbol under the position
      */
-    getDefinition(file: BscFile, position: Position): Location[];
+    getDefinition(file: File, position: Position): Location[];
     /**
      * @param className - The name of the class (including namespace if possible)
      * @param callsiteNamespace - the name of the namespace where the call site resides (this is NOT the known namespace of the class).
@@ -278,24 +283,7 @@ export declare class Scope {
      */
     getClassHierarchy(className: string, callsiteNamespace?: string): FileLink<ClassStatement>[];
 }
-interface NamespaceContainer {
-    file: BscFile;
-    fullName: string;
-    fullNameLower: string;
-    parentNameLower: string;
-    nameParts: Identifier[];
-    nameRange: Range;
-    lastPartName: string;
-    lastPartNameLower: string;
-    statements: Statement[];
-    classStatements: Map<string, ClassStatement>;
-    functionStatements: Map<string, FunctionStatement>;
-    enumStatements: Map<string, EnumStatement>;
-    constStatements: Map<string, ConstStatement>;
-    namespaces: Map<string, NamespaceContainer>;
-    symbolTable: SymbolTable;
-}
 interface AugmentedNewExpression extends NewExpression {
-    file: BscFile;
+    file: File;
 }
 export {};