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

package/dist/lsp/PathFilterer.d.ts

@@ -0,0 +1,75 @@
+import type { Logger } from '../logging';
+/**
+ * Manage collections of glob patterns used to filter paths.
+ *
+ * excludeLists are evaluated first to see if a path should be excluded. If the path is excluded, we then test it against the includeLists.
+ * If the path matches an includeList, it will be included. If not, it will remain excluded.
+ */
+export declare class PathFilterer {
+    constructor(options?: {
+        logger?: Logger;
+    });
+    private logger;
+    private includeCollections;
+    private excludeCollections;
+    /**
+     * Filter the given list of entries based on the registered include and exclude lists.
+     * @param entries the list of paths (or objects having paths) to filter
+     * @param fetcher a function that can extract the path from the entry if it's not a string
+     * @returns the filtered list of entries
+     */
+    filter<T = string>(entries: T[], fetcher?: (path: T) => string): T[];
+    /**
+     * Does the path match at least one of the exclusions lists
+     */
+    private isExclusionsMatch;
+    /**
+     * Does the path match at least one of the inclusions lists
+     */
+    private isInclusionsMatch;
+    /**
+     * Register a list of inclusive globs that should be evaluated together
+     * These should be things like the `files` array from a bsconfig.json
+     */
+    registerIncludeList(rootDir: string, globs: string[]): () => void;
+    /**
+     * Register glob patterns for files that should be _excluded_. positive patterns mean a file is excluded,
+     * and negative patterns mean a file that was previously matched (excluded) should be unmatched (included)
+     * These should be things like .gitignore or vscode's `files.exclude`.
+     *
+     * @example
+     * ```typescript
+     * [
+     *     '.git',
+     *     'node_modules'
+     *     '!node_modules/@rokucommunity/bslib'
+     * ]
+     * ```
+     * would exclude all files in the `.git` and `node_modules` directories, but would include the `node_modules/@rokucommunity/bslib` directory
+     */
+    registerExcludeList(rootDir: string, globs: string[]): () => void;
+    registerExcludeMatcher(matcher: (path: string) => boolean): () => void;
+    private removeCollection;
+    /**
+     * Remove all registered collections
+     */
+    clear(): void;
+}
+export declare class PathCollection {
+    options: {
+        rootDir: string;
+        globs: string[];
+    } | {
+        matcher: (path: string) => boolean;
+        isExcludePattern: boolean;
+    };
+    constructor(options: {
+        rootDir: string;
+        globs: string[];
+    } | {
+        matcher: (path: string) => boolean;
+        isExcludePattern: boolean;
+    });
+    private matchers;
+    isMatch(path: string): boolean;
+}

package/dist/lsp/PathFilterer.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathCollection = exports.PathFilterer = void 0;
+const micromatch = require("micromatch");
+const path = require("path");
+const logging_1 = require("../logging");
+const util_1 = require("../util");
+/**
+ * Manage collections of glob patterns used to filter paths.
+ *
+ * excludeLists are evaluated first to see if a path should be excluded. If the path is excluded, we then test it against the includeLists.
+ * If the path matches an includeList, it will be included. If not, it will remain excluded.
+ */
+class PathFilterer {
+    constructor(options) {
+        var _a;
+        this.includeCollections = [];
+        this.excludeCollections = [];
+        this.logger = (_a = options === null || options === void 0 ? void 0 : options.logger) !== null && _a !== void 0 ? _a : (0, logging_1.createLogger)();
+    }
+    /**
+     * Filter the given list of entries based on the registered include and exclude lists.
+     * @param entries the list of paths (or objects having paths) to filter
+     * @param fetcher a function that can extract the path from the entry if it's not a string
+     * @returns the filtered list of entries
+     */
+    filter(entries, fetcher) {
+        var _a;
+        //if there are no exclude lists, then all files should be included
+        if (this.excludeCollections.length === 0) {
+            return entries;
+        }
+        let results = [];
+        //process each path
+        for (let entry of entries) {
+            let srcPath = (_a = fetcher === null || fetcher === void 0 ? void 0 : fetcher(entry)) !== null && _a !== void 0 ? _a : entry;
+            //if this path is excluded
+            if (this.isExclusionsMatch(srcPath)) {
+                //if this path is re-included, keep it
+                if (this.isInclusionsMatch(srcPath)) {
+                    results.push(entry);
+                }
+                else {
+                    //this path should be excluded
+                }
+                //this path is not excluded, so keep it
+            }
+            else {
+                results.push(entry);
+            }
+        }
+        return results;
+    }
+    /**
+     * Does the path match at least one of the exclusions lists
+     */
+    isExclusionsMatch(path) {
+        //does this path match an exclusion list?
+        for (const collection of this.excludeCollections) {
+            if (collection.isMatch(path)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Does the path match at least one of the inclusions lists
+     */
+    isInclusionsMatch(path) {
+        //does this path match an exclusion list?
+        for (const collection of this.includeCollections) {
+            if (collection.isMatch(path)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Register a list of inclusive globs that should be evaluated together
+     * These should be things like the `files` array from a bsconfig.json
+     */
+    registerIncludeList(rootDir, globs) {
+        this.logger.debug('registerIncludeList', { rootDir: rootDir, globs: globs });
+        let collection = new PathCollection({
+            rootDir: rootDir,
+            globs: globs
+        });
+        this.includeCollections.push(collection);
+        return () => {
+            this.removeCollection(collection);
+        };
+    }
+    /**
+     * Register glob patterns for files that should be _excluded_. positive patterns mean a file is excluded,
+     * and negative patterns mean a file that was previously matched (excluded) should be unmatched (included)
+     * These should be things like .gitignore or vscode's `files.exclude`.
+     *
+     * @example
+     * ```typescript
+     * [
+     *     '.git',
+     *     'node_modules'
+     *     '!node_modules/@rokucommunity/bslib'
+     * ]
+     * ```
+     * would exclude all files in the `.git` and `node_modules` directories, but would include the `node_modules/@rokucommunity/bslib` directory
+     */
+    registerExcludeList(rootDir, globs) {
+        this.logger.debug('registerExcludeList', { rootDir: rootDir, globs: globs });
+        let collection = new PathCollection({
+            rootDir: rootDir,
+            globs: globs
+        });
+        this.excludeCollections.push(collection);
+        return () => {
+            this.removeCollection(collection);
+        };
+    }
+    registerExcludeMatcher(matcher) {
+        this.logger.debug('registerExcludeMatcher', matcher);
+        const collection = new PathCollection({
+            matcher: matcher,
+            isExcludePattern: false
+        });
+        this.excludeCollections.push(collection);
+        return () => {
+            this.removeCollection(collection);
+        };
+    }
+    removeCollection(collection) {
+        let idx = this.includeCollections.indexOf(collection);
+        if (idx > -1) {
+            this.includeCollections.splice(idx, 1);
+        }
+        idx = this.excludeCollections.indexOf(collection);
+        if (idx > -1) {
+            this.excludeCollections.splice(idx, 1);
+        }
+    }
+    /**
+     * Remove all registered collections
+     */
+    clear() {
+        this.includeCollections = [];
+        this.excludeCollections = [];
+    }
+}
+exports.PathFilterer = PathFilterer;
+class PathCollection {
+    constructor(options) {
+        var _a;
+        this.options = options;
+        this.matchers = [];
+        if ('globs' in options) {
+            //build matcher patterns from the globs
+            for (let glob of (_a = options.globs) !== null && _a !== void 0 ? _a : []) {
+                let isExcludePattern = glob.startsWith('!');
+                if (isExcludePattern) {
+                    glob = glob.substring(1);
+                }
+                const pattern = path.resolve(options.rootDir, glob).replace(/\\+/g, '/');
+                this.matchers.push({
+                    pattern: pattern,
+                    isMatch: micromatch.matcher(pattern),
+                    isExcludePattern: isExcludePattern
+                });
+            }
+        }
+        else {
+            this.matchers.push({
+                isMatch: options.matcher,
+                isExcludePattern: options.isExcludePattern
+            });
+        }
+    }
+    isMatch(path) {
+        let keep = false;
+        //coerce the path into a normalized form and unix slashes
+        path = util_1.default.standardizePath(path).replace(/\\+/g, '/');
+        for (let matcher of this.matchers) {
+            //exclusion pattern: do not keep the path if it matches
+            if (matcher.isExcludePattern) {
+                if (matcher.isMatch(path)) {
+                    keep = false;
+                }
+                //inclusion pattern: keep the path if it matches
+            }
+            else {
+                keep = keep || matcher.isMatch(path);
+            }
+        }
+        return keep;
+    }
+}
+exports.PathCollection = PathCollection;
+//# sourceMappingURL=PathFilterer.js.map

package/dist/lsp/PathFilterer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathFilterer.js","sourceRoot":"","sources":["../../src/lsp/PathFilterer.ts"],"names":[],"mappings":"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"}

package/dist/lsp/Project.d.ts

@@ -0,0 +1,200 @@
+import type { ProjectConfig, ActivateResponse, LspDiagnostic, LspProject, FileRenameTextEdit } from './LspProject';
+import type { Hover, MaybePromise } from '../interfaces';
+import type { DocumentSymbol, Position, Range, Location, WorkspaceSymbol } from 'vscode-languageserver-protocol';
+import { CompletionList } from 'vscode-languageserver-protocol';
+import type { DocumentAction, DocumentActionWithStatus } from './DocumentManager';
+import type { SignatureInfoObj } from '../Program';
+import type { BsConfig } from '../BsConfig';
+import type { Logger } from '../logging';
+export declare class Project implements LspProject {
+    constructor(options?: {
+        logger?: Logger;
+    });
+    /**
+     * Activates this project. Every call to `activate` should completely reset the project, clear all used ram and start from scratch.
+     */
+    activate(options: ProjectConfig): Promise<ActivateResponse>;
+    isStandaloneProject: boolean;
+    logger: Logger;
+    /**
+     * Options used to activate this project
+     */
+    activateOptions: ProjectConfig;
+    get rootDir(): string;
+    /**
+     * The file patterns from bsconfig.json that were used to find all files for this project
+     */
+    get filePatterns(): string[];
+    /**
+     * Gets resolved when the project has finished activating
+     */
+    private activationDeferred;
+    /**
+     * Promise that resolves when the project finishes activating
+     * @returns a promise that resolves when the project finishes activating
+     */
+    whenActivated(): Promise<void>;
+    private validationCancelToken;
+    /**
+     * Validate the project. This will trigger a full validation on any scopes that were changed since the last validation,
+     * and will also eventually emit a new 'diagnostics' event that includes all diagnostics for the project.
+     *
+     * This will cancel any currently running validation and then run a new one.
+     */
+    validate(): Promise<void>;
+    /**
+     * Cancel any active running validation
+     */
+    cancelValidate(): void;
+    getDiagnostics(): LspDiagnostic[];
+    /**
+     * Promise that resolves the next time the system is idle. If the system is already idle, it will resolve immediately
+     */
+    private onIdle;
+    /**
+     * Add or replace the in-memory contents of the file at the specified path. This is typically called as the user is typing.
+     * This will cancel any pending validation cycles and queue a future validation cycle instead.
+     */
+    applyFileChanges(documentActions: DocumentAction[]): Promise<DocumentActionWithStatus[]>;
+    /**
+     * Determine if this project will accept the file at the specified path (i.e. does it match a pattern in the project's files array)
+     */
+    static willAcceptFile(srcPath: string, files: BsConfig['files'], rootDir: string): boolean;
+    /**
+     * Set new contents for a file. This is safe to call any time. Changes will be queued and flushed at the correct times
+     * during the program's lifecycle flow
+     * @param srcPath absolute source path of the file
+     * @param fileContents the text contents of the file
+     * @returns true if this program accepted and added the file. false if the program didn't want the file, or if the contents didn't change
+     */
+    private setFile;
+    /**
+     * Remove the in-memory file at the specified path. This is typically called when the user (or file system watcher) triggers a file delete
+     * @param srcPath absolute path to the File
+     * @returns true if we found and removed at least one file, or false if no files were removed
+     */
+    private removeFileOrDirectory;
+    /**
+     * Get the full list of semantic tokens for the given file path
+     * @param options options for getting semantic tokens
+     * @param options.srcPath absolute path to the source file
+     */
+    getSemanticTokens(options: {
+        srcPath: string;
+    }): Promise<import("../interfaces").SemanticToken[]>;
+    transpileFile(options: {
+        srcPath: string;
+    }): Promise<import("../Program").FileTranspileResult>;
+    getHover(options: {
+        srcPath: string;
+        position: Position;
+    }): Promise<Hover[]>;
+    getDefinition(options: {
+        srcPath: string;
+        position: Position;
+    }): Promise<Location[]>;
+    getSignatureHelp(options: {
+        srcPath: string;
+        position: Position;
+    }): Promise<SignatureInfoObj[]>;
+    getDocumentSymbol(options: {
+        srcPath: string;
+    }): Promise<DocumentSymbol[]>;
+    getWorkspaceSymbol(): Promise<WorkspaceSymbol[]>;
+    getReferences(options: {
+        srcPath: string;
+        position: Position;
+    }): Promise<Location[]>;
+    getFileRenameEdits(options: {
+        oldSrcPath: string;
+        newSrcPath: string;
+    }): Promise<FileRenameTextEdit[]>;
+    /**
+     * Determine the pkg path for a (not-yet-existing) renamed file. Tries the project's `files` glob first
+     * so custom dest mappings keep working, and falls back to a plain rootDir-relative path so renames into
+     * folders that aren't yet in the glob still get their imports rewritten.
+     * Returns undefined if the new path is outside this project's rootDir.
+     */
+    private computeDestPathForNewSrcPath;
+    getSelectionRanges(options: {
+        srcPath: string;
+        positions: Position[];
+    }): Promise<import("vscode-languageserver-types").SelectionRange[]>;
+    getCodeActions(options: {
+        srcPath: string;
+        range: Range;
+    }): Promise<import("vscode-languageserver-types").CodeAction[]>;
+    getSourceFixAllCodeActions(options: {
+        srcPath: string;
+    }): Promise<import("vscode-languageserver-types").CodeAction[]>;
+    getCompletions(options: {
+        srcPath: string;
+        position: Position;
+    }): Promise<CompletionList>;
+    /**
+     * Manages the BrighterScript program. The main interface into the compiler/validator
+     */
+    private builder;
+    /**
+     * A unique key to represent this project. The format of this key may change, but it will always be unique to this project and can be used for comparison purposes.
+     *
+     * For directory-only projects, this is the path to the dir. For bsconfig.json projects, this is the path to the config file (typically bsconfig.json).
+     */
+    projectKey: string;
+    /**
+     * The directory for the root of this project (typically where the bsconfig.json or manifest is located)
+     */
+    projectDir: string;
+    /**
+     * A unique number for this project, generated during this current language server session. Mostly used so we can identify which project is doing logging
+     */
+    projectNumber: number;
+    /**
+     * The path to the workspace where this project resides. A workspace can have multiple projects (by adding a bsconfig.json to each folder).
+     * Defaults to `.projectPath` if not set
+     */
+    workspaceFolder: string;
+    /**
+     * Path to a bsconfig.json file that will be used for this project
+     */
+    bsconfigPath?: string;
+    /**
+     * The contents of the bsconfig.json file. This is used to detect when the bsconfig file has not actually been changed (even if the fs says it did).
+     *
+     * Only available after `.activate()` has completed.
+     * @deprecated do not depend on this property. This will certainly be removed in a future release
+     */
+    bsconfigFileContents?: string;
+    /**
+     * The contents of the manifest file. This is used to detect when the manifest file has not actually been changed (even if the fs says it did).
+     *
+     * Only available after `.activate()` has completed.
+     * @deprecated do not depend on this property. This will certainly be removed in a future release
+     */
+    manifestFileContents?: string;
+    /**
+     * The absolute source path to the manifest file (the file that maps to dest 'manifest').
+     * May differ from rootDir/manifest if the project uses a custom {src; dest} mapping.
+     *
+     * Only available after `.activate()` has completed.
+     */
+    manifestSrcPath?: string;
+    /**
+     * Find the path to the bsconfig.json file for this project
+     * @returns path to bsconfig.json, or undefined if unable to find it
+     */
+    private getConfigFilePath;
+    on(eventName: 'validate-begin', handler: (data: any) => MaybePromise<void>): any;
+    on(eventName: 'validate-end', handler: (data: any) => MaybePromise<void>): any;
+    on(eventName: 'critical-failure', handler: (data: {
+        message: string;
+    }) => MaybePromise<void>): any;
+    on(eventName: 'diagnostics', handler: (data: {
+        diagnostics: LspDiagnostic[];
+    }) => MaybePromise<void>): any;
+    on(eventName: 'all', handler: (eventName: string, data: any) => MaybePromise<void>): any;
+    private emit;
+    private emitter;
+    disposables: LspProject['disposables'];
+    dispose(): void;
+}