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

package/dist/parser/BrightScriptDocParser.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.brsDocParser = exports.BrightScriptDoc = exports.BrightScriptDocParser = exports.BrsDocTagKind = void 0;
+const util_1 = require("../util");
+const Parser_1 = require("./Parser");
+const reflection_1 = require("../astUtils/reflection");
+const tagRegex = /@(\w+)(?:\s+(.*))?/;
+const paramRegex = /(?:{([^}]*)}\s+)?(?:(\[?\w+\]?))\s*(.*)/;
+const returnRegex = /(?:{([^}]*)})?\s*(.*)/;
+const typeTagRegex = /(?:{([^}]*)})?/;
+var BrsDocTagKind;
+(function (BrsDocTagKind) {
+    BrsDocTagKind["Description"] = "description";
+    BrsDocTagKind["Param"] = "param";
+    BrsDocTagKind["Return"] = "return";
+    BrsDocTagKind["Type"] = "type";
+})(BrsDocTagKind = exports.BrsDocTagKind || (exports.BrsDocTagKind = {}));
+class BrightScriptDocParser {
+    parseNode(node) {
+        const commentTokens = [];
+        const result = this.parse(util_1.default.getNodeDocumentation(node, {
+            prettyPrint: false,
+            commentTokens: commentTokens
+        }), commentTokens);
+        for (const tag of result.tags) {
+            if (tag.typeExpression) {
+                tag.typeExpression.symbolTable = node.getSymbolTable();
+            }
+        }
+        return result;
+    }
+    parse(documentation, matchingTokens = []) {
+        const brsDoc = new BrightScriptDoc(documentation);
+        if (!documentation) {
+            return brsDoc;
+        }
+        const lines = documentation.split('\n');
+        const blockLines = [];
+        const descriptionLines = [];
+        let lastTag;
+        let haveMatchingTokens = false;
+        if (lines.length === matchingTokens.length) {
+            // We locations for each line, so we can add Locations
+            haveMatchingTokens = true;
+        }
+        function augmentLastTagWithBlockLines() {
+            if (blockLines.length > 0 && lastTag) {
+                // add to the description or details to previous tag
+                if (typeof lastTag.description !== 'undefined') {
+                    lastTag.description += '\n' + blockLines.map(obj => obj.line).join('\n');
+                    lastTag.description = lastTag.description.trim();
+                }
+                if (typeof lastTag.detail !== 'undefined') {
+                    lastTag.detail += '\n' + blockLines.map(obj => obj.line).join('\n');
+                    lastTag.detail = lastTag.detail.trim();
+                }
+                if (haveMatchingTokens) {
+                    lastTag.location = util_1.default.createBoundingLocation(lastTag.location, blockLines[blockLines.length - 1].token.location);
+                }
+            }
+            blockLines.length = 0;
+        }
+        for (let line of lines) {
+            let token = haveMatchingTokens ? matchingTokens.shift() : undefined;
+            line = line.trim();
+            while (line.startsWith('\'')) {
+                // remove leading apostrophes
+                line = line.substring(1).trim();
+            }
+            if (!line.startsWith('@')) {
+                if (lastTag) {
+                    blockLines.push({ line: line, token: token });
+                }
+                else if (descriptionLines.length > 0 || line) {
+                    // add a line to the list if it's not empty
+                    descriptionLines.push({ line: line, token: token });
+                }
+            }
+            else {
+                augmentLastTagWithBlockLines();
+                const newTag = this.parseLine(line, token);
+                lastTag = newTag;
+                if (newTag) {
+                    brsDoc.tags.push(newTag);
+                }
+            }
+        }
+        augmentLastTagWithBlockLines();
+        brsDoc.description = descriptionLines.map(obj => obj.line).join('\n').trim();
+        return brsDoc;
+    }
+    getTypeLocationFromToken(token) {
+        if (!(token === null || token === void 0 ? void 0 : token.location)) {
+            return undefined;
+        }
+        const startCurly = token.text.indexOf('{');
+        const endCurly = token.text.indexOf('}');
+        if (startCurly === -1 || endCurly === -1 || endCurly <= startCurly) {
+            return undefined;
+        }
+        return {
+            uri: token.location.uri,
+            range: {
+                start: {
+                    line: token.location.range.start.line,
+                    character: token.location.range.start.character + startCurly + 1
+                },
+                end: {
+                    line: token.location.range.start.line,
+                    character: token.location.range.start.character + endCurly
+                }
+            }
+        };
+    }
+    parseLine(line, token) {
+        var _a;
+        line = line.trim();
+        const match = tagRegex.exec(line);
+        if (!match) {
+            return;
+        }
+        const tagName = match[1];
+        const detail = (_a = match[2]) !== null && _a !== void 0 ? _a : '';
+        let result = {
+            tagName: tagName,
+            detail: detail
+        };
+        switch (tagName) {
+            case BrsDocTagKind.Param:
+                result = this.parseParam(detail);
+                break;
+            case BrsDocTagKind.Return:
+            case 'returns':
+                result = this.parseReturn(detail);
+                break;
+            case BrsDocTagKind.Type:
+                result = this.parseType(detail);
+                break;
+        }
+        return Object.assign(Object.assign({}, result), { token: token, location: token === null || token === void 0 ? void 0 : token.location });
+    }
+    parseParam(detail) {
+        var _a, _b, _c;
+        let type = '';
+        let description = '';
+        let optional = false;
+        let paramName = '';
+        let match = paramRegex.exec(detail);
+        if (match) {
+            type = (_a = match[1]) !== null && _a !== void 0 ? _a : '';
+            paramName = (_b = match[2]) !== null && _b !== void 0 ? _b : '';
+            description = (_c = match[3]) !== null && _c !== void 0 ? _c : '';
+        }
+        else {
+            paramName = detail.trim();
+        }
+        if (paramName) {
+            optional = paramName.startsWith('[') && paramName.endsWith(']');
+            paramName = paramName.replace(/\[|\]/g, '').trim();
+        }
+        return {
+            tagName: BrsDocTagKind.Param,
+            name: paramName,
+            typeString: type,
+            typeExpression: this.getTypeExpressionFromTypeString(type),
+            description: description,
+            optional: optional,
+            detail: detail
+        };
+    }
+    parseReturn(detail) {
+        var _a, _b;
+        let match = returnRegex.exec(detail);
+        let type = '';
+        let description = '';
+        if (match) {
+            type = (_a = match[1]) !== null && _a !== void 0 ? _a : '';
+            description = (_b = match[2]) !== null && _b !== void 0 ? _b : '';
+        }
+        return {
+            tagName: BrsDocTagKind.Return,
+            typeString: type,
+            typeExpression: this.getTypeExpressionFromTypeString(type),
+            description: description,
+            detail: detail
+        };
+    }
+    parseType(detail) {
+        var _a;
+        let match = typeTagRegex.exec(detail);
+        let type = '';
+        if (match) {
+            if (match[1]) {
+                type = (_a = match[1]) !== null && _a !== void 0 ? _a : '';
+            }
+        }
+        return {
+            tagName: BrsDocTagKind.Type,
+            typeString: type,
+            typeExpression: this.getTypeExpressionFromTypeString(type),
+            detail: detail
+        };
+    }
+    getTypeExpressionFromTypeString(typeString) {
+        var _a;
+        if (!typeString) {
+            return undefined;
+        }
+        let result;
+        try {
+            let { ast } = Parser_1.Parser.parse(typeString);
+            if ((0, reflection_1.isExpressionStatement)((_a = ast === null || ast === void 0 ? void 0 : ast.statements) === null || _a === void 0 ? void 0 : _a[0])) {
+                result = ast.statements[0].expression;
+            }
+        }
+        catch (e) {
+            //ignore
+        }
+        return result;
+    }
+}
+exports.BrightScriptDocParser = BrightScriptDocParser;
+class BrightScriptDoc {
+    constructor(documentation) {
+        this.documentation = documentation;
+        this.tags = [];
+    }
+    set description(value) {
+        this._description = value;
+    }
+    get description() {
+        var _a;
+        const descTag = this.tags.find((tag) => {
+            return tag.tagName === BrsDocTagKind.Description;
+        });
+        let result = (_a = this._description) !== null && _a !== void 0 ? _a : '';
+        if (descTag) {
+            const descTagDetail = descTag.detail;
+            result = result ? result + '\n' + descTagDetail : descTagDetail;
+        }
+        return result.trim();
+    }
+    getParam(name) {
+        const lowerName = name.toLowerCase();
+        return this.tags.find((tag) => {
+            return tag.tagName === BrsDocTagKind.Param && tag.name.toLowerCase() === lowerName;
+        });
+    }
+    getReturn() {
+        return this.tags.find((tag) => {
+            return tag.tagName === BrsDocTagKind.Return || tag.tagName === 'returns';
+        });
+    }
+    getTypeTag() {
+        return this.tags.find((tag) => {
+            return tag.tagName === BrsDocTagKind.Type;
+        });
+    }
+    getTypeTagByName(name) {
+        const lowerName = name.toLowerCase();
+        return this.tags.find((tag) => {
+            return tag.tagName === BrsDocTagKind.Type && tag.name.toLowerCase() === lowerName;
+        });
+    }
+    getTag(tagName) {
+        return this.tags.find((tag) => {
+            return tag.tagName === tagName;
+        });
+    }
+    getAllTags(tagName) {
+        return this.tags.filter((tag) => {
+            return tag.tagName === tagName;
+        });
+    }
+    getParamBscType(name, options = { flags: 2 /* SymbolTypeFlag.typetime */ }) {
+        var _a;
+        const param = this.getParam(name);
+        return (_a = param === null || param === void 0 ? void 0 : param.typeExpression) === null || _a === void 0 ? void 0 : _a.getType(Object.assign(Object.assign({}, options), { flags: 2 /* SymbolTypeFlag.typetime */ }));
+    }
+    getReturnBscType(options = { flags: 2 /* SymbolTypeFlag.typetime */ }) {
+        var _a;
+        const retTag = this.getReturn();
+        return (_a = retTag === null || retTag === void 0 ? void 0 : retTag.typeExpression) === null || _a === void 0 ? void 0 : _a.getType(Object.assign(Object.assign({}, options), { flags: 2 /* SymbolTypeFlag.typetime */ }));
+    }
+    getTypeTagBscType(options = { flags: 2 /* SymbolTypeFlag.typetime */ }) {
+        var _a;
+        const typeTag = this.getTypeTag();
+        return (_a = typeTag === null || typeTag === void 0 ? void 0 : typeTag.typeExpression) === null || _a === void 0 ? void 0 : _a.getType(Object.assign(Object.assign({}, options), { flags: 2 /* SymbolTypeFlag.typetime */ }));
+    }
+}
+exports.BrightScriptDoc = BrightScriptDoc;
+exports.brsDocParser = new BrightScriptDocParser();
+exports.default = exports.brsDocParser;
+//# sourceMappingURL=BrightScriptDocParser.js.map

package/dist/parser/BrightScriptDocParser.js.map

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

package/dist/parser/BrsTranspileState.d.ts

@@ -1,7 +1,9 @@
-import type { Range } from 'vscode-languageserver';
+import type { Location } from 'vscode-languageserver';
+import { Editor } from '../astUtils/Editor';
 import type { BrsFile } from '../files/BrsFile';
-import type { ClassStatement } from './Statement';
+import type { ClassStatement, ConditionalCompileStatement } from './Statement';
 import { TranspileState } from './TranspileState';
+import type { Statement } from './AstNode';
 export declare class BrsTranspileState extends TranspileState {
     file: BrsFile;
     constructor(file: BrsFile);
@@ -14,10 +16,27 @@ export declare class BrsTranspileState extends TranspileState {
      * Used to assist blocks in knowing when to add a comment statement to the same line as the first line of the parent
      */
     lineage: {
-        range: Range;
+        location?: Location;
     }[];
     /**
      * Used by ClassMethodStatements to determine information about their enclosing class
      */
     classStatement?: ClassStatement;
+    /**
+     * An AST editor that can be used by the AST nodes to do various transformations to the AST which will be reverted at the end of the transpile cycle
+     * TODO remove this before file_api is merged
+     */
+    editor: Editor;
+    /**
+     * Used by ConditionalCompileStatement to determine if there's already an conditional compile going on
+     */
+    conditionalCompileStatement?: ConditionalCompileStatement;
+    /**
+     * Do not transpile leading comments
+     */
+    skipLeadingComments: boolean;
+    /**
+     * Transpile all leading trivia for a given statement, including comments mixed between annotations
+     */
+    transpileAnnotations(node: Statement): (string | import("source-map").SourceNode)[][];
 }

package/dist/parser/BrsTranspileState.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BrsTranspileState = void 0;
+const Editor_1 = require("../astUtils/Editor");
 const TranspileState_1 = require("./TranspileState");
 class BrsTranspileState extends TranspileState_1.TranspileState {
     constructor(file) {
@@ -11,8 +12,26 @@ class BrsTranspileState extends TranspileState_1.TranspileState {
          * Used to assist blocks in knowing when to add a comment statement to the same line as the first line of the parent
          */
         this.lineage = [];
+        /**
+         * An AST editor that can be used by the AST nodes to do various transformations to the AST which will be reverted at the end of the transpile cycle
+         * TODO remove this before file_api is merged
+         */
+        this.editor = new Editor_1.Editor();
+        /**
+         * Do not transpile leading comments
+         */
+        this.skipLeadingComments = false;
         this.bslibPrefix = this.file.program.bslibPrefix;
     }
+    /**
+     * Transpile all leading trivia for a given statement, including comments mixed between annotations
+     */
+    transpileAnnotations(node) {
+        var _a;
+        return ((_a = node === null || node === void 0 ? void 0 : node.annotations) !== null && _a !== void 0 ? _a : []).map(x => {
+            return x.transpile(this);
+        });
+    }
 }
 exports.BrsTranspileState = BrsTranspileState;
 //# sourceMappingURL=BrsTranspileState.js.map

package/dist/parser/BrsTranspileState.js.map

@@ -1 +1 @@
-{"version":3,"file":"BrsTranspileState.js","sourceRoot":"","sources":["../../src/parser/BrsTranspileState.ts"],"names":[],"mappings":";;;AAGA,qDAAkD;AAElD,MAAa,iBAAkB,SAAQ,+BAAc;IACjD,YACW,IAAa;QAEpB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAFnC,SAAI,GAAJ,IAAI,CAAS;QAWxB;;;WAGG;QACH,YAAO,GAAG,EAER,CAAC;QAdC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;IACrD,CAAC;CAmBJ;AAzBD,8CAyBC"}
+{"version":3,"file":"BrsTranspileState.js","sourceRoot":"","sources":["../../src/parser/BrsTranspileState.ts"],"names":[],"mappings":";;;AACA,+CAA4C;AAG5C,qDAAkD;AAGlD,MAAa,iBAAkB,SAAQ,+BAAc;IACjD,YACW,IAAa;QAEpB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAFnC,SAAI,GAAJ,IAAI,CAAS;QAWxB;;;WAGG;QACH,YAAO,GAAG,EAER,CAAC;QAOH;;;WAGG;QACI,WAAM,GAAG,IAAI,eAAM,EAAE,CAAC;QAO7B;;WAEG;QACI,wBAAmB,GAAG,KAAK,CAAC;QAnC/B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;IACrD,CAAC;IAoCD;;OAEG;IACI,oBAAoB,CAAC,IAAe;;QACvC,OAAO,CAAC,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,WAAW,mCAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YACrC,OAAO,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAlDD,8CAkDC"}