brighterscript 1.0.0-alpha.5 → 1.0.0-alpha.51

package/dist/PluginInterface.js.map

@@ -1 +1 @@
-{"version":3,"file":"PluginInterface.js","sourceRoot":"","sources":["../src/PluginInterface.ts"],"names":[],"mappings":";;AAEA,qCAAoC;AAOpC,MAAqB,eAAe;IAEhC,YACY,OAAyB,EACzB,MAAc;QADd,YAAO,GAAP,OAAO,CAAkB;QACzB,WAAM,GAAN,MAAM,CAAQ;IACtB,CAAC;IAEL;;OAEG;IACI,IAAI,CAA6B,KAAQ,EAAE,GAAG,IAAqB;QACtE,KAAK,IAAI,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE;YAC7B,IAAK,MAAc,CAAC,KAAK,CAAC,EAAE;gBACxB,IAAI;oBACA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE;wBACvD,MAAc,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;oBACpC,CAAC,CAAC,CAAC;iBACN;gBAAC,OAAO,GAAG,EAAE;oBACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC;iBAChF;aACJ;SACJ;IACL,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,MAAsB;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SAChC;IACL,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,MAAsB;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAC7B;IACL,CAAC;IAEM,GAAG,CAAC,MAAsB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAEM,MAAM,CAAC,MAAsB;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;SACrD;IACL,CAAC;CACJ;AAnDD,kCAmDC"}
+{"version":3,"file":"PluginInterface.js","sourceRoot":"","sources":["../src/PluginInterface.ts"],"names":[],"mappings":"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"}

package/dist/Program.d.ts

@@ -1,44 +1,48 @@
-import type { CodeAction, CompletionItem, Position, Range, SignatureInformation, SymbolInformation } from 'vscode-languageserver';
-import { Location } from 'vscode-languageserver';
-import type { BsConfig } from './BsConfig';
+import type { CodeAction, Position, Range, SignatureInformation, Location, DocumentSymbol, CancellationToken, SelectionRange } from 'vscode-languageserver';
+import type { BsConfig, FinalizedBsConfig } from './BsConfig';
 import { Scope } from './Scope';
-import { BrsFile } from './files/BrsFile';
-import { XmlFile } from './files/XmlFile';
-import type { BsDiagnostic, FileReference, FileObj, BscFile, SemanticToken } from './interfaces';
+import type { NamespaceContainer, NamespaceFileContribution } from './Scope';
+import type { FileObj, SemanticToken, FileLink, Hover } from './interfaces';
 import { XmlScope } from './XmlScope';
-import { Logger } from './Logger';
+import type { Logger } from './logging';
 import PluginInterface from './PluginInterface';
-import type { FunctionStatement, Statement } from './parser/Statement';
-export interface SourceObj {
-    srcPath: string;
-    source: string;
-    definitions?: string;
-}
-export interface TranspileObj {
-    file: BscFile;
-    outputPath: string;
-}
+import type { FunctionStatement } from './parser/Statement';
+import { Editor } from './astUtils/Editor';
+import type { FileData } from './files/LazyFileData';
+import type { UnresolvedSymbol } from './AstValidationSegmenter';
+import type { BscFile } from './files/BscFile';
+import { CrossScopeValidator } from './CrossScopeValidator';
+import { DiagnosticManager } from './DiagnosticManager';
+import type { ProvidedSymbolInfo, BrsFile } from './files/BrsFile';
+import type { XmlFile } from './files/XmlFile';
+import type { Statement } from './parser/AstNode';
 export interface SignatureInfoObj {
     index: number;
     key: string;
     signature: SignatureInformation;
 }
-export interface FileLink<T> {
-    item: T;
-    file: BrsFile;
-}
 export declare class Program {
-    /**
-     * The root directory for this program
-     */
-    options: BsConfig;
     constructor(
     /**
      * The root directory for this program
      */
-    options: BsConfig, logger?: Logger, plugins?: PluginInterface);
+    options: BsConfig, logger?: Logger, plugins?: PluginInterface, diagnosticsManager?: DiagnosticManager);
+    options: FinalizedBsConfig;
     logger: Logger;
+    /**
+     * An editor that plugins can use to modify program-level things during the build flow. Don't use this to edit files (they have their own `.editor`)
+     */
+    editor: Editor;
+    /**
+     * A factory that creates `File` instances
+     */
+    private fileFactory;
     private createGlobalScope;
+    private recursivelyAddNodeToSymbolTable;
+    /**
+     * Do all setup required for the global symbol table.
+     */
+    private populateGlobalSymbolTable;
     /**
      * A graph of all files and their dependencies.
      * For example:
@@ -46,7 +50,7 @@ export declare class Program {
      *      lib2.brs -> [lib3.brs] //via an import statement
      */
     private dependencyGraph;
-    private diagnosticFilterer;
+    diagnostics: DiagnosticManager;
     /**
      * A scope that contains all built-in global functions.
      * All scopes should directly or indirectly inherit from this scope
@@ -56,30 +60,90 @@ export declare class Program {
      * Plugins which can provide extra diagnostics or transform AST
      */
     plugins: PluginInterface;
+    private fileSymbolInformation;
+    private currentScopeValidationOptions;
     /**
-     * A set of diagnostics. This does not include any of the scope diagnostics.
-     * Should only be set from `this.validate()`
+     *  Map of typetime symbols which depend upon the key symbol
      */
-    private diagnostics;
+    private symbolDependencies;
+    /**
+     * Symbol Table for storing custom component types
+     * This is a sibling to the global table (as Components can be used/referenced anywhere)
+     * Keeping custom components out of the global table and in a specific symbol table
+     * compartmentalizes their use
+     */
+    private componentsTable;
+    addFileSymbolInfo(file: BrsFile): void;
+    getFileSymbolInfo(file: BrsFile): {
+        provides: ProvidedSymbolInfo;
+        requires: UnresolvedSymbol[];
+    };
     /**
      * The path to bslib.brs (the BrightScript runtime for certain BrighterScript features)
      */
-    get bslibPkgPath(): "pkg:/source/roku_modules/bslib/bslib.brs" | "pkg:/source/roku_modules/rokucommunity_bslib/bslib.brs" | "pkg:/source/bslib.brs";
+    get bslibPkgPath(): string;
     get bslibPrefix(): "rokucommunity_bslib" | "bslib";
     /**
-     * A map of every file loaded ino this program, indexed by its lower-case pkgPath
+     * A map of every file loaded into this program, indexed by its original file location
+     */
+    files: Record<string, BscFile>;
+    /**
+     * A map of every file loaded into this program, indexed by its destPath
+     */
+    private destMap;
+    /**
+     * Plugins can contribute multiple virtual files for a single physical file.
+     * This collection links the virtual files back to the physical file that produced them.
+     * The key is the standardized and lower-cased srcPath
+     */
+    private fileClusters;
+    /**
+     * Map from a lower-cased namespace name part to the set of `BrsFile`s that contribute
+     * to it. Built lazily, invalidated whenever any file is added, removed, or re-parsed
+     * (`setFile` and `removeFile` both clear it).
+     *
+     * Used by `ScopeNamespaceLookup` to resolve a namespace name to its contributing
+     * files in O(1), then intersect against the scope's file set.
+     */
+    private namespaceContributors;
+    /**
+     * Look up the set of `BrsFile`s that declare any part of the given namespace name
+     * (lowercased). Returns `undefined` when no file contributes.
+     * @internal
      */
-    private pkgMap;
+    protected getNamespaceContributors(namespaceNameLower: string): Set<BrsFile> | undefined;
+    private buildNamespaceContributors;
     /**
-     * A map of every file loaded into this program, indexed by its lower-case srcPath
+     * Cached slow-path namespace aggregates, keyed by `(nameLower, sorted-contributor-pkgPaths)`.
+     * Two scopes with the same in-scope file set for a multi-contributor namespace share
+     * the same aggregate object (and therefore the same merged statement collections and
+     * symbolTable instance). Built lazily, invalidated alongside `namespaceContributors`.
+     *
+     * The aggregate is stored as a `NamespaceContainer` whose `namespaces` field is an
+     * empty Map: scopes always wrap the aggregate before returning to plugins, and the
+     * wrapper supplies its own scope-filtered children. Plugins never see the aggregate
+     * directly.
      */
-    private files;
+    private aggregateNamespaceContainerCache;
     /**
-     * Get a copy of the list of files currently loaded in the program
+     * Get or build the shared aggregate for a namespace whose in-scope contributors
+     * include more than one file. The aggregate's heavy fields are computed once per
+     * unique `(nameLower, contributing-files-set)` and reused across every scope that
+     * sees the same set.
+     * @internal
      */
-    getFiles(): (BrsFile | XmlFile)[];
+    protected getAggregateNamespaceContainer(nameLower: string, contributions: NamespaceFileContribution[]): NamespaceContainer;
+    private buildAggregateNamespaceContainer;
+    /**
+     * Invalidate the program-level namespace contributors map and the slow-path aggregate
+     * cache. Called by `setFile` and `removeFile`; downstream scope namespace lookups
+     * already rebuild via the dependency-graph invalidation chain, so this only needs
+     * to drop the cached maps.
+     */
+    private invalidateNamespaceContributorCache;
     private scopes;
     protected addScope(scope: Scope): void;
+    protected removeScope(scope: Scope): void;
     /**
      * A map of every component currently loaded into the program, indexed by the component name.
      * It is a compile-time error to have multiple components with the same name. However, we store an array of components
@@ -94,6 +158,15 @@ export declare class Program {
         file: XmlFile;
         scope: XmlScope;
     };
+    /**
+     * Get the sorted names of custom components
+     */
+    getSortedComponentNames(): string[];
+    /**
+     * Keeps a set of all the components that need to have their types updated during the current validation cycle
+     * Map <componentKey, componentName>
+     */
+    private componentSymbolsToUpdate;
     /**
      * Register (or replace) the reference to a component in the component map
      */
@@ -102,6 +175,26 @@ export declare class Program {
      * Remove the specified component from the components map
      */
     private unregisterComponent;
+    /**
+     * Adds a component described in an XML to the set of components that needs to be updated this validation cycle.
+     * @param xmlFile XML file with <component> tag
+     */
+    private addDeferredComponentTypeSymbolCreation;
+    private getComponentKey;
+    /**
+     * Resolves symbol table with the first component in this.components to have the same name as the component in the file
+     * @param componentKey key getting a component from `this.components`
+     * @param componentName the unprefixed name of the component that will be added (e.g. 'MyLabel' NOT 'roSgNodeMyLabel')
+     */
+    private updateComponentSymbolInGlobalScope;
+    /**
+     * Adds a reference type to the global symbol table with the first component in this.components to have the same name as the component in the file
+     * This is so on a first validation, these types can be resolved in teh future (eg. when the actual component is created)
+     * If we don't add reference types at this top level, they will be created at the file level, and will never get resolved
+     * @param componentKey key getting a component from `this.components`
+     * @param componentName the unprefixed name of the component that will be added (e.g. 'MyLabel' NOT 'roSgNodeMyLabel')
+     */
+    private addComponentReferenceType;
     /**
      * re-attach the dependency graph with a new key for any component who changed
      * their position in their own named array (only matters when there are multiple
@@ -112,24 +205,22 @@ export declare class Program {
      * Get a list of all files that are included in the project but are not referenced
      * by any scope in the program.
      */
-    getUnreferencedFiles(): (BrsFile | XmlFile)[];
+    getUnreferencedFiles(): BscFile[];
     /**
-     * Get the list of errors for the entire program. It's calculated on the fly
-     * by walking through every file, so call this sparingly.
+     * Get the list of errors for the entire program.
      */
-    getDiagnostics(): BsDiagnostic[];
-    addDiagnostics(diagnostics: BsDiagnostic[]): void;
+    getDiagnostics(): import("./interfaces").BsDiagnostic[];
     /**
      * Determine if the specified file is loaded in this program right now.
-     * @param filePath
+     * @param filePath the absolute or relative path to the file
      * @param normalizePath should the provided path be normalized before use
      */
     hasFile(filePath: string, normalizePath?: boolean): boolean;
     /**
      * roku filesystem is case INsensitive, so find the scope by key case insensitive
-     * @param scopeName
+     * @param scopeName xml scope names are their `destPath`. Source scope is stored with the key `"source"`
      */
-    getScopeByName(scopeName: string): Scope;
+    getScopeByName(scopeName: string): Scope | undefined;
     /**
      * Return all scopes
      */
@@ -149,16 +240,34 @@ export declare class Program {
     /**
      * Load a file into the program. If that file already exists, it is replaced.
      * If file contents are provided, those are used, Otherwise, the file is loaded from the file system
-     * @param srcDestOrPkgPath the absolute path, or the pkg path (i.e. `pkg:/path/to/file.brs`) or the destPath (i.e. `path/to/file.brs` relative to `pkg:/`)
-     * @param fileContents the file contents
+     * @param srcDestOrPkgPath the absolute path, the pkg path (i.e. `pkg:/path/to/file.brs`), or the destPath (i.e. `path/to/file.brs` relative to `pkg:/`)
+     * @param fileData the file contents. omit or pass `undefined` to prevent loading the data at this time
      */
-    setFile<T extends BscFile>(srcDestOrPkgPath: string, fileContents: string): T;
+    setFile<T extends BscFile>(srcDestOrPkgPath: string, fileData?: FileData): T;
     /**
      * Load a file into the program. If that file already exists, it is replaced.
      * @param fileEntry an object that specifies src and dest for the file.
-     * @param fileContents the file contents. If not provided, the file will be loaded from disk
+     * @param fileData the file contents. omit or pass `undefined` to prevent loading the data at this time
+     */
+    setFile<T extends BscFile>(fileEntry: FileObj, fileData: FileData): T;
+    /**
+     * Given a srcPath, a destPath, or both, resolve whichever is missing, relative to rootDir.
+     * @param fileParam an object representing file paths
+     * @param rootDir must be a pre-normalized path
+     */
+    private getPaths;
+    /**
+     * Remove any leading `pkg:/` found in the path
+     */
+    private removePkgPrefix;
+    /**
+     * Is this file a .brs file found somewhere within the `pkg:/source/` folder?
      */
-    setFile<T extends BscFile>(fileEntry: FileObj, fileContents: string): T;
+    private isSourceBrsFile;
+    /**
+     * Is this file a .brs file found somewhere within the `pkg:/source/` folder?
+     */
+    private isComponentsXmlFile;
     /**
      * Ensure source scope is created.
      * Note: automatically called internally, and no-op if it exists already.
@@ -166,114 +275,209 @@ export declare class Program {
     createSourceScope(): void;
     /**
      * Remove a set of files from the program
-     * @param srcPaths
+     * @param srcPaths can be an array of srcPath or destPath strings
+     * @param normalizePath should this function repair and standardize the filePaths? Passing false should have a performance boost if you can guarantee your paths are already sanitized
      */
-    removeFiles(srcPaths: string[]): void;
+    removeFiles(srcPaths: string[], normalizePath?: boolean): void;
     /**
      * Remove a file from the program
-     * @param filePath can be a srcPath, a pkgPath, or a destPath (same as pkgPath but without `pkg:/`)
+     * @param filePath can be a srcPath, a destPath, or a destPath with leading `pkg:/`
      * @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
-
      */
-    removeFile(filePath: string, normalizePath?: boolean): void;
+    removeFile(filePath: string, normalizePath?: boolean, keepSymbolInformation?: boolean): void;
+    crossScopeValidation: CrossScopeValidator;
+    private isFirstValidation;
+    private validationDetails;
+    lastValidationInfo: {
+        brsFilesSrcPath: Set<string>;
+        xmlFilesSrcPath: Set<string>;
+        scopeNames: Set<string>;
+        componentsRebuilt: Set<string>;
+    };
+    /**
+     * Counter used to track which validation run is being logged
+     */
+    private validationRunSequence;
     /**
-     * Remove all files from the program that are in the specified folder path (recursive)
-     * @param folderSrcPath The absolute path to the folder on disk
-     * @param normalizePath should the provided path be normalized before use?
+     * How many milliseconds can pass while doing synchronous operations in validate before we register a short timeout (i.e. yield to the event loop)
      */
-    removeFilesInFolder(folderSrcPath: string, normalizePath?: boolean): void;
+    private validationMinSyncDuration;
+    private validatePromise;
     /**
      * Traverse the entire project, and validate all scopes
-     * @param force - if true, then all scopes are force to validate, even if they aren't marked as dirty
      */
     validate(): void;
+    validate(options: {
+        async: false;
+        cancellationToken?: CancellationToken;
+    }): void;
+    validate(options: {
+        async: true;
+        cancellationToken?: CancellationToken;
+    }): Promise<void>;
+    private getScopesForCrossScopeValidation;
+    private doesXmlFileRequireProvidedSymbols;
     /**
      * Flag all duplicate component names
      */
     private detectDuplicateComponentNames;
     /**
-     * Determine at least one scope has the file
+     * Get the files for a list of filePaths
+     * @param filePaths can be an array of srcPath or a destPath strings
+     * @param normalizePath should this function repair and standardize the paths? Passing false should have a performance boost if you can guarantee your paths are already sanitized
      */
-    private fileIsIncludedInAnyScope;
+    getFiles<T extends BscFile>(filePaths: string[], normalizePath?: boolean): T[];
+    private getFilePathCache;
     /**
      * Get the file at the given path
-     * @param filePath can be a srcPath, a pkgPath, or a destPath (same as pkgPath but without `pkg:/`)
+     * @param filePath can be a srcPath or a 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<T extends BscFile>(filePath: string, normalizePath?: boolean): T;
+    private sortedScopeNames;
+    /**
+     * Gets a sorted list of all scopeNames, always beginning with "global", "source", then any others in alphabetical order
+     */
+    private getSortedScopeNames;
     /**
      * Get a list of all scopes the file is loaded into
-     * @param file
+     * @param file the file
+     */
+    getScopesForFile(file: BscFile | string): Scope[];
+    /**
+     * Get the first found scope for a file.
      */
-    getScopesForFile(file: XmlFile | BrsFile): Scope[];
+    getFirstScopeForFile(file: BscFile): Scope | undefined;
     getStatementsByName(name: string, originFile: BrsFile, namespaceName?: string): FileLink<Statement>[];
     getStatementsForXmlFile(scope: XmlScope, filterName?: string): FileLink<FunctionStatement>[];
     /**
      * Find all available completion items at the given position
-     * @param srcPath The absolute path to the source file on disk
-     * @param lineIndex
-     * @param columnIndex
+     * @param filePath can be a srcPath or a destPath
+     * @param position the position (line & column) where completions should be found
      */
-    getCompletions(srcPath: string, position: Position): CompletionItem[];
+    getCompletions(filePath: string, position: Position): import("vscode-languageserver-types").CompletionItem[];
     /**
      * Goes through each file and builds a list of workspace symbols for the program. Used by LanguageServer's onWorkspaceSymbol functionality
      */
-    getWorkspaceSymbols(): SymbolInformation[];
+    getWorkspaceSymbols(): import("vscode-languageserver-types").WorkspaceSymbol[];
     /**
      * Given a position in a file, if the position is sitting on some type of identifier,
      * go to the definition of that identifier (where this thing was first defined)
-     * @param srcPath The absolute path to the source file on disk
      */
     getDefinition(srcPath: string, position: Position): Location[];
     /**
-     * @param srcPath The absolute path to the source file on disk
+     * Get hover information for a file and position
+     */
+    getHover(srcPath: string, position: Position): Hover[];
+    /**
+     * Get full list of document symbols for a file
+     * @param srcPath path to the file
      */
-    getHover(srcPath: string, position: Position): Promise<import("vscode-languageserver-types").Hover>;
+    getDocumentSymbols(srcPath: string): DocumentSymbol[] | undefined;
+    /**
+     * Get the selection ranges for the given positions in a file. Used for expand/shrink selection.
+     * @param srcPath path to the file
+     * @param positions the positions to get selection ranges for
+     */
+    getSelectionRanges(srcPath: string, positions: Position[]): SelectionRange[];
     /**
      * Compute code actions for the given file and range
-     * @param srcPath The absolute path to the source file on disk
      */
     getCodeActions(srcPath: string, range: Range): CodeAction[];
+    /**
+     * Compute "source fix all" code actions for the given file.
+     * Fires the `onGetSourceFixAllCodeActions` plugin event with all diagnostics for the file (no range filter),
+     * then converts each contributed SourceFixAllCodeAction into an LSP CodeAction.
+     */
+    getSourceFixAllCodeActions(srcPath: string): CodeAction[];
     /**
      * Get semantic tokens for the specified file
      */
-    getSemanticTokens(srcPath: string): SemanticToken[];
-    getSignatureHelp(filepath: string, position: Position): SignatureInfoObj[];
-    private getPartialStatementInfo;
-    private getPartialItemCounts;
+    getSemanticTokens(srcPath: string): SemanticToken[] | undefined;
+    getSignatureHelp(filePath: string, position: Position): SignatureInfoObj[];
+    getReferences(srcPath: string, position: Position): Location[];
     /**
-     * @param srcPath The absolute path to the source file on disk
+     * Transpile a single file and get the result as a string.
+     * This does not write anything to the file system.
+     *
+     * This should only be called by `LanguageServer`.
+     * Internal usage should call `_getTranspiledFileContents` instead.
+     * @param filePath can be a srcPath or a destPath
      */
-    getReferences(srcPath: string, position: Position): Location[] | Promise<Location[]>;
+    getTranspiledFileContents(filePath: string): Promise<FileTranspileResult>;
+    private getTranspiledFileContentsPipeline;
     /**
-     * Get a list of all script imports, relative to the specified pkgPath
-     * @param sourcePkgPath - the pkgPath of the source that wants to resolve script imports.
+     * Get the absolute output path for a file
      */
-    getScriptImportCompletions(sourcePkgPath: string, scriptImport: FileReference): CompletionItem[];
+    private getOutputPath;
+    private getOutDir;
     /**
-     * Transpile a single file and get the result as a string.
-     * This does not write anything to the file system.
-     * @param srcPath The absolute path to the source file on disk
+     * Prepare the program for building
+     * @param files the list of files that should be prepared
      */
-    getTranspiledFileContents(srcPath: string): {
-        srcPath: string;
-        pkgPath: string;
-        code: string;
-        map: import("source-map").SourceMapGenerator;
-    };
-    transpile(fileEntries: FileObj[], stagingFolderPath: string): Promise<void>;
+    private prepare;
     /**
-     * Find a list of files in the program that have a function with the given name (case INsensitive)
+     * Generate the contents of every file
      */
-    findFilesForFunction(functionName: string): (BrsFile | XmlFile)[];
+    private serialize;
+    /**
+     * Write the entire project to disk
+     */
+    private write;
+    private buildPipeline;
+    /**
+     * Build the project. This transpiles/transforms/copies all files and moves them to the staging directory
+     * @param options the list of options used to build the program
+     */
+    build(options?: ProgramBuildOptions): Promise<void>;
     /**
      * Find a list of files in the program that have a function with the given name (case INsensitive)
      */
-    findFilesForClass(className: string): (BrsFile | XmlFile)[];
+    findFilesForFunction(functionName: string): BscFile[];
     /**
-     * Get a map of the manifest information
+     * Find a list of files in the program that have a class with the given name (case INsensitive)
      */
-    getManifest(): Map<string, string | number | boolean>;
+    findFilesForClass(className: string): BscFile[];
+    findFilesForNamespace(name: string): BscFile[];
+    findFilesForEnum(name: string): BscFile[];
     private _manifest;
+    /**
+     * The absolute source path to the manifest file. Set when loadManifest is called.
+     */
+    manifestPath: string;
+    /**
+     * Modify a parsed manifest map by reading `bs_const` and injecting values from `options.manifest.bs_const`
+     * @param parsedManifest The manifest map to read from and modify
+     */
+    private buildBsConstsIntoParsedManifest;
+    /**
+     * Try to find and load the manifest into memory
+     * @param manifestFileObj A pointer to a potential manifest file object found during loading
+     * @param replaceIfAlreadyLoaded should we overwrite the internal `_manifest` if it already exists
+     */
+    loadManifest(manifestFileObj?: FileObj, replaceIfAlreadyLoaded?: boolean): void;
+    /**
+     * Get a map of the manifest information
+     */
+    getManifest(): Map<string, string>;
     dispose(): void;
 }
+export interface FileTranspileResult {
+    srcPath: string;
+    destPath: string;
+    pkgPath: string;
+    code: string;
+    map: string;
+    typedef: string;
+}
+export interface ProgramBuildOptions {
+    /**
+     * The directory where the final built files should be placed. This directory will be cleared before running
+     */
+    outDir?: string;
+    /**
+     * An array of files to build. If omitted, the entire list of files from the program will be used instead.
+     * Typically you will want to leave this blank
+     */
+    files?: BscFile[];
+}