brighterscript 0.66.0-alpha.9 → 0.67.1

package/dist/PluginInterface.d.ts

@@ -1,12 +1,19 @@
 import type { CompilerPlugin } from './interfaces';
-import type { Logger } from './Logger';
-export declare type Arguments<T> = [T] extends [(...args: infer U) => any] ? U : [T] extends [void] ? [] : [T];
+import { type Logger } from './logging';
+export declare type PluginEventArgs<T> = {
+    [K in keyof Required<T> as Required<T>[K] extends (...args: any[]) => any ? K : never]: Required<T>[K] extends (...args: any[]) => any ? Parameters<Required<T>[K]> : never;
+};
 export default class PluginInterface<T extends CompilerPlugin = CompilerPlugin> {
-    constructor(plugins: CompilerPlugin[], options: {
-        logger: Logger;
+    private plugins?;
+    constructor();
+    /**
+     * @deprecated use the `options` parameter pattern instead
+     */
+    constructor(plugins?: CompilerPlugin[], logger?: Logger);
+    constructor(plugins?: CompilerPlugin[], options?: {
+        logger?: Logger;
         suppressErrors?: boolean;
     });
-    private plugins;
     private logger;
     /**
      * Should plugin errors cause the program to fail, or should they be caught and simply logged
@@ -15,11 +22,7 @@ export default class PluginInterface<T extends CompilerPlugin = CompilerPlugin>
     /**
      * Call `event` on plugins
      */
-    emit<K extends keyof T & string>(event: K, ...args: Arguments<T[K]>): Arguments<T[K]>[0];
-    /**
-     * Call `event` on plugins, but allow the plugins to return promises that will be awaited before the next plugin is notified
-     */
-    emitAsync<K extends keyof T & string>(event: K, ...args: Arguments<T[K]>): Promise<Arguments<T[K]>[0]>;
+    emit<K extends keyof PluginEventArgs<T> & string>(event: K, ...args: PluginEventArgs<T>[K]): void;
     /**
      * Add a plugin to the beginning of the list of plugins
      */
@@ -28,11 +31,6 @@ export default class PluginInterface<T extends CompilerPlugin = CompilerPlugin>
      * Add a plugin to the end of the list of plugins
      */
     add<T extends CompilerPlugin = CompilerPlugin>(plugin: T): T;
-    /**
-     * Find deprecated or removed historic plugin hooks, and warn about them.
-     * Some events can be forwards-converted
-     */
-    private sanitizePlugin;
     has(plugin: CompilerPlugin): boolean;
     remove<T extends CompilerPlugin = CompilerPlugin>(plugin: T): T;
     /**

package/dist/PluginInterface.js

@@ -1,55 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const Logger_1 = require("./Logger");
+const logging_1 = require("./logging");
 class PluginInterface {
     constructor(plugins, options) {
-        this.plugins = [];
-        this.logger = options === null || options === void 0 ? void 0 : options.logger;
-        this.suppressErrors = (options === null || options === void 0 ? void 0 : options.suppressErrors) === false ? false : true;
-        for (const plugin of plugins) {
-            this.add(plugin);
+        var _a;
+        this.plugins = plugins;
+        (_a = this.plugins) !== null && _a !== void 0 ? _a : (this.plugins = []);
+        if ((options === null || options === void 0 ? void 0 : options.constructor.name) === 'Logger') {
+            this.logger = options;
+        }
+        else {
+            this.logger = options === null || options === void 0 ? void 0 : options.logger;
+            this.suppressErrors = (options === null || options === void 0 ? void 0 : options.suppressErrors) === false ? false : true;
+        }
+        if (!this.logger) {
+            this.logger = (0, logging_1.createLogger)();
         }
     }
     /**
      * Call `event` on plugins
      */
     emit(event, ...args) {
-        var _a, _b;
         for (let plugin of this.plugins) {
             if (plugin[event]) {
                 try {
-                    (_a = this.logger) === null || _a === void 0 ? void 0 : _a.time(Logger_1.LogLevel.debug, [plugin.name, event], () => {
+                    this.logger.time(logging_1.LogLevel.debug, [plugin.name, event], () => {
                         plugin[event](...args);
                     });
                 }
                 catch (err) {
-                    (_b = this.logger) === null || _b === void 0 ? void 0 : _b.error(`Error when calling plugin ${plugin.name}.${event}:`, err);
+                    this.logger.error(`Error when calling plugin ${plugin.name}.${event}:`, err);
                     if (!this.suppressErrors) {
                         throw err;
                     }
                 }
             }
         }
-        return args[0];
-    }
-    /**
-     * Call `event` on plugins, but allow the plugins to return promises that will be awaited before the next plugin is notified
-     */
-    async emitAsync(event, ...args) {
-        var _a, _b;
-        for (let plugin of this.plugins) {
-            if (plugin[event]) {
-                try {
-                    await ((_a = this.logger) === null || _a === void 0 ? void 0 : _a.time(Logger_1.LogLevel.debug, [plugin.name, event], async () => {
-                        await Promise.resolve(plugin[event](...args));
-                    }));
-                }
-                catch (err) {
-                    (_b = this.logger) === null || _b === void 0 ? void 0 : _b.error(`Error when calling plugin ${plugin.name}.${event}:`, err);
-                }
-            }
-        }
-        return args[0];
     }
     /**
      * Add a plugin to the beginning of the list of plugins
@@ -65,56 +51,16 @@ class PluginInterface {
      */
     add(plugin) {
         if (!this.has(plugin)) {
-            this.sanitizePlugin(plugin);
             this.plugins.push(plugin);
         }
         return plugin;
     }
-    /**
-     * Find deprecated or removed historic plugin hooks, and warn about them.
-     * Some events can be forwards-converted
-     */
-    sanitizePlugin(plugin) {
-        var _a, _b, _c;
-        const removedHooks = [
-            'beforePrepublish',
-            'afterPrepublish'
-        ];
-        for (const removedHook of removedHooks) {
-            if (plugin[removedHook]) {
-                (_a = this.logger) === null || _a === void 0 ? void 0 : _a.error(`Plugin "${plugin.name}": event ${removedHook} is no longer supported and will never be called`);
-            }
-        }
-        const upgradeWithWarn = {
-            beforePublish: 'beforeSerializeProgram',
-            afterPublish: 'afterSerializeProgram',
-            beforeProgramTranspile: 'beforeBuildProgram',
-            afterProgramTranspile: 'afterBuildProgram',
-            beforeFileParse: 'beforeProvideFile',
-            afterFileParse: 'afterProvideFile',
-            beforeFileTranspile: 'beforePrepareFile',
-            afterFileTranspile: 'afterPrepareFile',
-            beforeFileDispose: 'beforeFileRemove',
-            afterFileDispose: 'afterFileRemove'
-        };
-        for (const [oldEvent, newEvent] of Object.entries(upgradeWithWarn)) {
-            if (plugin[oldEvent]) {
-                if (!plugin[newEvent]) {
-                    plugin[newEvent] = plugin[oldEvent];
-                    (_b = this.logger) === null || _b === void 0 ? void 0 : _b.warn(`Plugin '${plugin.name}': event '${oldEvent}' is no longer supported. It has been converted to '${newEvent}' but you may encounter issues as their signatures do not match.`);
-                }
-                else {
-                    (_c = this.logger) === null || _c === void 0 ? void 0 : _c.warn(`Plugin "${plugin.name}": event '${oldEvent}' is no longer supported and will never be called`);
-                }
-            }
-        }
-    }
     has(plugin) {
         return this.plugins.includes(plugin);
     }
     remove(plugin) {
         if (this.has(plugin)) {
-            this.plugins.splice(this.plugins.indexOf(plugin), 1);
+            this.plugins.splice(this.plugins.indexOf(plugin));
         }
         return plugin;
     }

package/dist/PluginInterface.js.map

@@ -1 +1 @@
-{"version":3,"file":"PluginInterface.js","sourceRoot":"","sources":["../src/PluginInterface.ts"],"names":[],"mappings":";;AAEA,qCAAoC;AAOpC,MAAqB,eAAe;IAChC,YACI,OAAyB,EACzB,OAGC;QASG,YAAO,GAAqB,EAAE,CAAC;QAPnC,IAAI,CAAC,MAAM,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,CAAC,OAAe,aAAf,OAAO,uBAAP,OAAO,CAAU,cAAc,MAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAChF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;YAC1B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;SACpB;IACL,CAAC;IAUD;;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,MAAA,IAAI,CAAC,MAAM,0CAAE,IAAI,CAAC,iBAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE;wBACxD,MAAc,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;oBACpC,CAAC,CAAC,CAAC;iBACN;gBAAC,OAAO,GAAG,EAAE;oBACV,MAAA,IAAI,CAAC,MAAM,0CAAE,KAAK,CAAC,6BAA6B,MAAM,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC;oBAC9E,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;wBACtB,MAAM,GAAG,CAAC;qBACb;iBACJ;aACJ;SACJ;QACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,SAAS,CAA6B,KAAQ,EAAE,GAAG,IAAqB;;QACjF,KAAK,IAAI,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE;YAC7B,IAAK,MAAc,CAAC,KAAK,CAAC,EAAE;gBACxB,IAAI;oBACA,MAAM,CAAA,MAAA,IAAI,CAAC,MAAM,0CAAE,IAAI,CAAC,iBAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE;wBACrE,MAAM,OAAO,CAAC,OAAO,CAChB,MAAc,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAClC,CAAC;oBACN,CAAC,CAAC,CAAA,CAAC;iBACN;gBAAC,OAAO,GAAG,EAAE;oBACV,MAAA,IAAI,CAAC,MAAM,0CAAE,KAAK,CAAC,6BAA6B,MAAM,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC;iBACjF;aACJ;SACJ;QACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,QAAQ,CAA4C,MAAS;QAChE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SAChC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,GAAG,CAA4C,MAAS;QAC3D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YACnB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAC7B;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;OAGG;IACK,cAAc,CAAC,MAAsB;;QACzC,MAAM,YAAY,GAAG;YACjB,kBAAkB;YAClB,iBAAiB;SACpB,CAAC;QACF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE;YACpC,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE;gBACrB,MAAA,IAAI,CAAC,MAAM,0CAAE,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,YAAY,WAAW,kDAAkD,CAAC,CAAC;aACvH;SACJ;QAED,MAAM,eAAe,GAAG;YACpB,aAAa,EAAE,wBAAwB;YACvC,YAAY,EAAE,uBAAuB;YACrC,sBAAsB,EAAE,oBAAoB;YAC5C,qBAAqB,EAAE,mBAAmB;YAC1C,eAAe,EAAE,mBAAmB;YACpC,cAAc,EAAE,kBAAkB;YAClC,mBAAmB,EAAE,mBAAmB;YACxC,kBAAkB,EAAE,kBAAkB;YACtC,iBAAiB,EAAE,kBAAkB;YACrC,gBAAgB,EAAE,iBAAiB;SACtC,CAAC;QAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;YAChE,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE;gBAClB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;oBACnB,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACpC,MAAA,IAAI,CAAC,MAAM,0CAAE,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,aAAa,QAAQ,uDAAuD,QAAQ,kEAAkE,CAAC,CAAC;iBACnM;qBAAM;oBACH,MAAA,IAAI,CAAC,MAAM,0CAAE,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,aAAa,QAAQ,mDAAmD,CAAC,CAAC;iBACrH;aACJ;SACJ;IACL,CAAC;IAEM,GAAG,CAAC,MAAsB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAEM,MAAM,CAA4C,MAAS;QAC9D,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;SACxD;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACtB,CAAC;CACJ;AA9ID,kCA8IC"}
+{"version":3,"file":"PluginInterface.js","sourceRoot":"","sources":["../src/PluginInterface.ts"],"names":[],"mappings":";;AACA,uCAAgE;AAsBhE,MAAqB,eAAe;IAiBhC,YACY,OAA0B,EAClC,OAGU;;QAJF,YAAO,GAAP,OAAO,CAAmB;QAMlC,MAAA,IAAI,CAAC,OAAO,oCAAZ,IAAI,CAAC,OAAO,GAAK,EAAE,EAAC;QACpB,IAAI,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,CAAC,IAAI,MAAK,QAAQ,EAAE;YACxC,IAAI,CAAC,MAAM,GAAG,OAA4B,CAAC;SAC9C;aAAM;YACH,IAAI,CAAC,MAAM,GAAI,OAAe,aAAf,OAAO,uBAAP,OAAO,CAAU,MAAM,CAAC;YACvC,IAAI,CAAC,cAAc,GAAG,CAAC,OAAe,aAAf,OAAO,uBAAP,OAAO,CAAU,cAAc,MAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;SACnF;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YACd,IAAI,CAAC,MAAM,GAAG,IAAA,sBAAY,GAAE,CAAC;SAChC;IACL,CAAC;IASD;;OAEG;IACI,IAAI,CAA8C,KAAQ,EAAE,GAAG,IAA2B;QAC7F,KAAK,IAAI,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE;YAC7B,IAAK,MAAc,CAAC,KAAK,CAAC,EAAE;gBACxB,IAAI;oBACA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAQ,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;oBAC7E,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;wBACtB,MAAM,GAAG,CAAC;qBACb;iBACJ;aACJ;SACJ;IACL,CAAC;IAED;;OAEG;IACI,QAAQ,CAA4C,MAAS;QAChE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SAChC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,GAAG,CAA4C,MAAS;QAC3D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAC7B;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEM,GAAG,CAAC,MAAsB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAEM,MAAM,CAA4C,MAAS;QAC9D,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;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACtB,CAAC;CACJ;AApGD,kCAoGC"}

package/dist/Program.d.ts

@@ -1,48 +1,42 @@
-import type { CodeAction, Position, Range, SignatureInformation, Location } from 'vscode-languageserver';
-import type { BsConfig } from './BsConfig';
+import type { CodeAction, CompletionItem, Position, Range, SignatureInformation, Location, DocumentSymbol } from 'vscode-languageserver';
+import type { BsConfig, FinalizedBsConfig } from './BsConfig';
 import { Scope } from './Scope';
-import type { BrsFile, ProvidedSymbolInfo } from './files/BrsFile';
-import type { XmlFile } from './files/XmlFile';
-import type { BsDiagnostic, FileObj, SemanticToken, FileLink, Hover } from './interfaces';
-import type { File } from './files/File';
+import { BrsFile } from './files/BrsFile';
+import { XmlFile } from './files/XmlFile';
+import type { BsDiagnostic, File, FileReference, FileObj, BscFile, 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 } from './parser/Statement';
-import { Editor } from './astUtils/Editor';
+import type { SourceMapGenerator } from 'source-map';
 import type { Statement } from './parser/AstNode';
-import type { FileData } from './files/LazyFileData';
-import type { UnresolvedSymbol } from './AstValidationSegmenter';
+export interface SourceObj {
+    /**
+     * @deprecated use `srcPath` instead
+     */
+    pathAbsolute: string;
+    srcPath: string;
+    source: string;
+    definitions?: string;
+}
+export interface TranspileObj {
+    file: BscFile;
+    outputPath: string;
+}
 export interface SignatureInfoObj {
     index: number;
     key: string;
     signature: SignatureInformation;
 }
 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: 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:
@@ -66,12 +60,6 @@ export declare class Program {
      * Should only be set from `this.validate()`
      */
     private diagnostics;
-    private fileSymbolInformation;
-    addFileSymbolInfo(file: BrsFile): void;
-    getFileSymbolInfo(file: BrsFile): {
-        provides: ProvidedSymbolInfo;
-        requires: UnresolvedSymbol[];
-    };
     /**
      * The path to bslib.brs (the BrightScript runtime for certain BrighterScript features)
      */
@@ -80,17 +68,8 @@ export declare class Program {
     /**
      * A map of every file loaded into this program, indexed by its original file location
      */
-    files: Record<string, File>;
-    /**
-     * 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;
+    files: Record<string, BscFile>;
+    private pkgMap;
     private scopes;
     protected addScope(scope: Scope): void;
     /**
@@ -107,10 +86,6 @@ export declare class Program {
         file: XmlFile;
         scope: XmlScope;
     };
-    /**
-     * Keeps a set of all the components that need to have their types updated during the current validation cycle
-     */
-    private componentSymbolsToUpdate;
     /**
      * Register (or replace) the reference to a component in the component map
      */
@@ -119,18 +94,6 @@ 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;
-    /**
-     * Updates the global 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;
     /**
      * 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
@@ -154,11 +117,11 @@ export declare class Program {
      * @param normalizePath should the provided path be normalized before use
      */
     hasFile(filePath: string, normalizePath?: boolean): boolean;
+    getPkgPath(...args: any[]): any;
     /**
      * roku filesystem is case INsensitive, so find the scope by key case insensitive
-     * @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
      */
@@ -175,21 +138,36 @@ export declare class Program {
      * Remove this file from internal maps
      */
     private unassignFile;
+    /**
+     * 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 srcPath the file path relative to the root dir
+     * @param fileContents the file contents
+     * @deprecated use `setFile` instead
+     */
+    addOrReplaceFile<T extends BscFile>(srcPath: string, fileContents: string): 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
+     * @deprecated use `setFile` instead
+     */
+    addOrReplaceFile<T extends BscFile>(fileEntry: FileObj, fileContents: string): T;
     /**
      * 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, 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
+     * @param fileContents the file contents
      */
-    setFile<T extends File>(srcDestOrPkgPath: string, fileData?: FileData): T;
+    setFile<T extends BscFile>(srcDestOrPkgPath: string, fileContents: string): 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 fileData the file contents. omit or pass `undefined` to prevent loading the data at this time
+     * @param fileContents the file contents. If not provided, the file will be loaded from disk
      */
-    setFile<T extends File>(fileEntry: FileObj, fileData: FileData): T;
+    setFile<T extends BscFile>(fileEntry: FileObj, fileContents: string): T;
     /**
-     * Given a srcPath, a destPath, or both, resolve whichever is missing, relative to rootDir.
+     * Given a srcPath, a pkgPath, or both, resolve whichever is missing, relative to rootDir.
      * @param fileParam an object representing file paths
      * @param rootDir must be a pre-normalized path
      */
@@ -199,18 +177,30 @@ export declare class Program {
      */
     private removePkgPrefix;
     /**
-     * Is this file a .brs file found somewhere within the `pkg:/source/` folder?
+     * Ensure source scope is created.
+     * Note: automatically called internally, and no-op if it exists already.
      */
-    private isSourceBrsFile;
+    createSourceScope(): void;
     /**
-     * Is this file a .brs file found somewhere within the `pkg:/source/` folder?
+     * Find the file by its absolute path. This is case INSENSITIVE, since
+     * Roku is a case insensitive file system. It is an error to have multiple files
+     * with the same path with only case being different.
+     * @param srcPath the absolute path to the file
+     * @deprecated use `getFile` instead, which auto-detects the path type
      */
-    private isComponentsXmlFile;
+    getFileByPathAbsolute<T extends BrsFile | XmlFile>(srcPath: string): T;
     /**
-     * Ensure source scope is created.
-     * Note: automatically called internally, and no-op if it exists already.
+     * Get a list of files for the given (platform-normalized) pkgPath array.
+     * Missing files are just ignored.
+     * @deprecated use `getFiles` instead, which auto-detects the path types
      */
-    createSourceScope(): void;
+    getFilesByPkgPaths<T extends BscFile[]>(pkgPaths: string[]): T;
+    /**
+     * Get a file with the specified (platform-normalized) pkg path.
+     * If not found, return undefined
+     * @deprecated use `getFile` instead, which auto-detects the path type
+     */
+    getFileByPkgPath<T extends BscFile>(pkgPath: string): T;
     /**
      * Remove a set of files from the program
      * @param srcPaths can be an array of srcPath or destPath strings
@@ -219,29 +209,14 @@ export declare class Program {
     removeFiles(srcPaths: string[], normalizePath?: boolean): void;
     /**
      * Remove a file from the program
-     * @param filePath can be a srcPath, a destPath, or a destPath with leading `pkg:/`
+     * @param filePath can be a srcPath, a pkgPath, or a destPath (same as pkgPath but without `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, keepSymbolInformation?: boolean): void;
-    lastValidationInfo: Map<string, {
-        symbolsNotDefinedInEveryScope: {
-            symbol: UnresolvedSymbol;
-            scope: Scope;
-        }[];
-        duplicateSymbolsInSameScope: {
-            symbol: UnresolvedSymbol;
-            scope: Scope;
-        }[];
-        symbolsNotConsistentAcrossScopes: {
-            symbol: UnresolvedSymbol;
-            scopes: Scope[];
-        }[];
-    }>;
+    removeFile(filePath: string, normalizePath?: boolean): void;
     /**
      * Traverse the entire project, and validate all scopes
      */
     validate(): void;
-    private detectIncompatibleSymbolsAcrossScopes;
     /**
      * Flag all duplicate component names
      */
@@ -251,22 +226,22 @@ export declare class Program {
      * @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
      */
-    getFiles<T extends File>(filePaths: string[], normalizePath?: boolean): T[];
+    getFiles<T extends BscFile>(filePaths: string[], normalizePath?: boolean): T[];
     /**
      * Get the file at the given path
      * @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 File>(filePath: string, normalizePath?: boolean): T;
+    getFile<T extends BscFile>(filePath: string, normalizePath?: boolean): T;
     /**
      * Get a list of all scopes the file is loaded into
      * @param file the file
      */
-    getScopesForFile(file: File | string): Scope[];
+    getScopesForFile(file: XmlFile | BrsFile | string): Scope[];
     /**
      * Get the first found scope for a file.
      */
-    getFirstScopeForFile(file: File): Scope;
+    getFirstScopeForFile(file: XmlFile | BrsFile): Scope | undefined;
     getStatementsByName(name: string, originFile: BrsFile, namespaceName?: string): FileLink<Statement>[];
     getStatementsForXmlFile(scope: XmlScope, filterName?: string): FileLink<FunctionStatement>[];
     /**
@@ -274,11 +249,11 @@ export declare class Program {
      * @param filePath can be a srcPath or a destPath
      * @param position the position (line & column) where completions should be found
      */
-    getCompletions(filePath: string, position: Position): import("vscode-languageserver").CompletionItem[];
+    getCompletions(filePath: string, position: Position): CompletionItem[];
     /**
      * Goes through each file and builds a list of workspace symbols for the program. Used by LanguageServer's onWorkspaceSymbol functionality
      */
-    getWorkspaceSymbols(): import("vscode-languageserver").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)
@@ -288,6 +263,11 @@ export declare class Program {
      * 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
+     */
+    getDocumentSymbols(srcPath: string): DocumentSymbol[] | undefined;
     /**
      * Compute code actions for the given file and range
      */
@@ -295,9 +275,14 @@ export declare class Program {
     /**
      * Get semantic tokens for the specified file
      */
-    getSemanticTokens(srcPath: string): SemanticToken[];
+    getSemanticTokens(srcPath: string): SemanticToken[] | undefined;
     getSignatureHelp(filepath: string, position: Position): SignatureInfoObj[];
-    getReferences(srcPath: string, position: Position): Location[] | Promise<Location[]>;
+    getReferences(srcPath: string, position: Position): Location[];
+    /**
+     * 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.
+     */
+    getScriptImportCompletions(sourcePkgPath: string, scriptImport: FileReference): CompletionItem[];
     /**
      * Transpile a single file and get the result as a string.
      * This does not write anything to the file system.
@@ -307,64 +292,46 @@ export declare class Program {
      * @param filePath can be a srcPath or a destPath
      */
     getTranspiledFileContents(filePath: string): Promise<FileTranspileResult>;
-    private getTranspiledFileContentsPipeline;
     /**
-     * Get the absolute output path for a file
+     * Internal function used to transpile files.
+     * This does not write anything to the file system
      */
-    private getOutputPath;
-    private getStagingDir;
+    private _getTranspiledFileContents;
+    private beforeProgramTranspile;
+    transpile(fileEntries: FileObj[], stagingDir: string): Promise<void>;
+    private afterProgramTranspile;
     /**
-     * Prepare the program for building
-     * @param files the list of files that should be prepared
-     */
-    private prepare;
-    /**
-     * Generate the contents of every file
+     * Find a list of files in the program that have a function with the given name (case INsensitive)
      */
-    private serialize;
+    findFilesForFunction(functionName: string): BscFile[];
     /**
-     * Write the entire project to disk
+     * Find a list of files in the program that have a class with the given name (case INsensitive)
      */
-    private write;
-    private buildPipeline;
+    findFilesForClass(className: string): BscFile[];
+    findFilesForNamespace(name: string): BscFile[];
+    findFilesForEnum(name: string): BscFile[];
+    private _manifest;
     /**
-     * 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
+     * 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
      */
-    build(options?: ProgramBuildOptions): Promise<void>;
+    private buildBsConstsIntoParsedManifest;
     /**
-     * Find a list of files in the program that have a function with the given name (case INsensitive)
+     * 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
      */
-    findFilesForFunction(functionName: string): File[];
-    /**
-     * Find a list of files in the program that have a class with the given name (case INsensitive)
-     */
-    findFilesForClass(className: string): File[];
-    findFilesForNamespace(name: string): File[];
-    findFilesForEnum(name: string): File[];
+    loadManifest(manifestFileObj?: FileObj, replaceIfAlreadyLoaded?: boolean): void;
     /**
      * Get a map of the manifest information
      */
     getManifest(): Map<string, string>;
-    private _manifest;
     dispose(): void;
 }
 export interface FileTranspileResult {
     srcPath: string;
-    destPath: string;
     pkgPath: string;
     code: string;
-    map: string;
+    map: SourceMapGenerator;
     typedef: string;
 }
-export interface ProgramBuildOptions {
-    /**
-     * The directory where the final built files should be placed. This directory will be cleared before running
-     */
-    stagingDir?: 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?: File[];
-}