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

package/dist/common/Sequencer.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sequencer = void 0;
+const util_1 = require("../util");
+const eventemitter3_1 = require("eventemitter3");
+const parseMilliseconds = require("parse-ms");
+const perf_hooks_1 = require("perf_hooks");
+/**
+ * Supports running a series of actions in sequence, either synchronously or asynchronously
+ * @private
+ */
+class Sequencer {
+    constructor(options) {
+        this.options = options;
+        // eslint-disable-next-line @typescript-eslint/ban-types
+        this.actions = [];
+        this.emitter = new eventemitter3_1.EventEmitter();
+        /**
+         * An object that collects timing information for our actions
+         */
+        this.metrics = new Map();
+    }
+    get minSyncDuration() {
+        var _a, _b;
+        return (_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.minSyncDuration) !== null && _b !== void 0 ? _b : 150;
+    }
+    forEach(label, itemsOrFactory, func) {
+        //register a single action for now, we will fetch the full list and register their actions later
+        const primaryAction = {
+            args: [],
+            label: label,
+            func: (data) => {
+                const items = typeof itemsOrFactory === 'function' ? itemsOrFactory() : itemsOrFactory;
+                const actions = [];
+                let i = 0;
+                for (const item of items) {
+                    actions.push({
+                        label: label + `[${i++}]`,
+                        groupLabel: label,
+                        args: [item],
+                        func: func
+                    });
+                }
+                let primaryActionIndex = this.actions.indexOf(primaryAction);
+                //insert all of these item actions immediately after this action
+                this.actions.splice(primaryActionIndex + 1, 0, ...actions);
+            }
+        };
+        this.actions.push(primaryAction);
+        return this;
+    }
+    onCancel(callback) {
+        this.emitter.on('cancel', callback);
+        return this;
+    }
+    onComplete(callback) {
+        this.emitter.on('complete', callback);
+        return this;
+    }
+    onSuccess(callback) {
+        this.emitter.on('success', callback);
+        return this;
+    }
+    once(label, func) {
+        this.actions.push({
+            args: [],
+            func: func,
+            label: label
+        });
+        return this;
+    }
+    async run() {
+        var _a, _b, _c, _d;
+        try {
+            let start = Date.now();
+            for (const action of this.actions) {
+                //register a very short timeout between every action so we don't hog the CPU
+                if (Date.now() - start > this.minSyncDuration) {
+                    await util_1.util.sleep(1);
+                    start = Date.now();
+                }
+                //if the cancellation token has asked us to cancel, then stop processing now
+                if ((_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.cancellationToken) === null || _b === void 0 ? void 0 : _b.isCancellationRequested) {
+                    return this.handleCancel();
+                }
+                await this.runActionAsync(action);
+                //if the cancellation token has asked us to cancel, then stop processing now
+                if ((_d = (_c = this.options) === null || _c === void 0 ? void 0 : _c.cancellationToken) === null || _d === void 0 ? void 0 : _d.isCancellationRequested) {
+                    return this.handleCancel();
+                }
+            }
+            this.emitter.emit('success');
+        }
+        catch (e) {
+            this.handleCancel();
+            throw e;
+        }
+        finally {
+            this.emitter.emit('complete');
+            this.dispose();
+        }
+    }
+    runSync() {
+        var _a, _b;
+        try {
+            for (const action of this.actions) {
+                //if the cancellation token has asked us to cancel, then stop processing now
+                if ((_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.cancellationToken) === null || _b === void 0 ? void 0 : _b.isCancellationRequested) {
+                    return this.handleCancel();
+                }
+                const result = this.runActionSync(action);
+                if (typeof (result === null || result === void 0 ? void 0 : result.then) === 'function') {
+                    throw new Error(`Action returned a promise which is unsupported when running 'runSync'`);
+                }
+            }
+            this.emitter.emit('success');
+        }
+        catch (e) {
+            this.handleCancel();
+            throw e;
+        }
+        finally {
+            this.emitter.emit('complete');
+            this.dispose();
+        }
+    }
+    async runActionAsync(action) {
+        //record the start time for this action
+        let perfBefore = perf_hooks_1.performance.now();
+        try {
+            return await Promise.resolve(action.func(...action.args));
+        }
+        finally {
+            let perfAfter = perf_hooks_1.performance.now();
+            this.incrementMetric(action.label, perfAfter - perfBefore, 1, !!action.groupLabel);
+            if (action.groupLabel) {
+                this.incrementMetric(action.groupLabel, perfAfter - perfBefore, 1);
+            }
+        }
+    }
+    runActionSync(action) {
+        //record the start time for this action
+        let perfBefore = perf_hooks_1.performance.now();
+        try {
+            return action.func(...action.args);
+        }
+        finally {
+            let perfAfter = perf_hooks_1.performance.now();
+            this.incrementMetric(action.label, perfAfter - perfBefore, 1, !!action.groupLabel);
+            if (action.groupLabel) {
+                this.incrementMetric(action.groupLabel, perfAfter - perfBefore, 1);
+            }
+        }
+    }
+    /**
+     * Get all the metrics in a text-based format (useful for logging)
+     */
+    formatMetrics(options) {
+        let results = [];
+        let total = 0;
+        for (const [label, metric] of this.metrics) {
+            //skip loop iterations if options say they should be skipped
+            if (metric.isLoopIteration && (options === null || options === void 0 ? void 0 : options.includeLoopIterations) !== true) {
+                continue;
+            }
+            //sum all the non-loop iterations (i.e. the one-off runs or grouped loop runs).
+            //this represents the total time spend running these tasks
+            if (!metric.isLoopIteration) {
+                total += metric.duration;
+            }
+            results.push({
+                label: label,
+                durationText: this.getDurationText(metric.duration),
+                callText: `${metric.callCount} calls`
+            });
+        }
+        let maxLabelLength = Math.max(...results.map(x => x.label.length));
+        let maxCallTextLength = Math.max(...results.map(x => x.callText.length));
+        let maxDurationLength = Math.max(...results.map(x => x.durationText.length));
+        results.push({
+            label: 'Total',
+            durationText: this.getDurationText(total),
+            callText: ''
+        });
+        return ((options === null || options === void 0 ? void 0 : options.header) ? options.header + '\n' : '') +
+            results.map(x => {
+                var _a, _b, _c;
+                return [
+                    '    ' + ((_a = x.label) !== null && _a !== void 0 ? _a : '').padEnd(maxLabelLength + 2, '-') +
+                        (' ' + ((_b = x.durationText) !== null && _b !== void 0 ? _b : '')).padStart(maxDurationLength + 2, '-') + ', ' +
+                        ((_c = x.callText) !== null && _c !== void 0 ? _c : '').padStart(maxCallTextLength, ' ')
+                ].join(', ');
+            }).join('\n');
+    }
+    getDurationText(duration) {
+        let parts = parseMilliseconds(duration);
+        let fractionalMilliseconds = parseInt(duration.toFixed(3).toString().split('.')[1]);
+        let result = `${parts.minutes}m${parts.seconds.toString().padStart(2, '0')}s${parts.milliseconds.toString().padStart(3, '0')}.${fractionalMilliseconds.toString().padStart(3, '0')}ms`;
+        //remove leading zeros for minutes and seconds
+        result = result.replace(/^0+m/, '').replace(/^0+s/, '');
+        return result;
+    }
+    /**
+     * Bump the metric for the given key by the given duration and call count
+     * @param label the label of the action to have its metric incremented
+     * @param duration the amount of new duration to add to the existing duration
+     * @param callCount the amount of new calls to add to the existing call count
+     */
+    incrementMetric(label, duration, callCount, isLoopIteration = false) {
+        let metric = this.metrics.get(label);
+        if (!metric) {
+            metric = {
+                duration: 0,
+                callCount: 0,
+                isLoopIteration: false
+            };
+            this.metrics.set(label, metric);
+        }
+        metric.duration += duration;
+        metric.callCount += callCount;
+        metric.isLoopIteration = isLoopIteration;
+    }
+    handleCancel() {
+        var _a;
+        console.log(`Cancelling sequence ${(_a = this.options) === null || _a === void 0 ? void 0 : _a.name}`);
+        this.emitter.emit('cancel');
+    }
+    dispose() {
+        this.emitter.removeAllListeners();
+    }
+}
+exports.Sequencer = Sequencer;
+//# sourceMappingURL=Sequencer.js.map

package/dist/common/Sequencer.js.map

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

package/dist/deferred.d.ts

@@ -1,4 +1,4 @@
-export declare class Deferred<T = void> {
+export declare class Deferred<T = void, TReject = any> {
     constructor();
     get promise(): Promise<T>;
     private _promise;
@@ -20,11 +20,13 @@ export declare class Deferred<T = void> {
     /**
      * Resolve the promise
      */
-    resolve(value: T): void;
+    resolve(value?: T): void;
     private _resolve;
+    tryResolve(value?: T): void;
     /**
      * Reject the promise
      */
-    reject(value: T): void;
+    reject(value: TReject): void;
     private _reject;
+    tryReject(reason?: TReject): void;
 }

package/dist/deferred.js

@@ -43,6 +43,11 @@ class Deferred {
         this._isResolved = true;
         this._resolve(value);
     }
+    tryResolve(value) {
+        if (!this.isCompleted) {
+            this.resolve(value);
+        }
+    }
     /**
      * Reject the promise
      */
@@ -54,6 +59,11 @@ class Deferred {
         this._isRejected = true;
         this._reject(value);
     }
+    tryReject(reason) {
+        if (!this.isCompleted) {
+            this.reject(reason);
+        }
+    }
 }
 exports.Deferred = Deferred;
 //# sourceMappingURL=deferred.js.map

package/dist/deferred.js.map

@@ -1 +1 @@
-{"version":3,"file":"deferred.js","sourceRoot":"","sources":["../src/deferred.ts"],"names":[],"mappings":";;;AAAA,MAAa,QAAQ;IACjB;QAiBQ,iBAAY,GAAG,KAAK,CAAC;QAQrB,gBAAW,GAAG,KAAK,CAAC;QAQpB,gBAAW,GAAG,KAAK,CAAC;QAhCxB,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC/C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QAC1B,CAAC,CAAC,CAAC;IACP,CAAC;IACD,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAGD;;OAEG;IACH,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAGD;;OAEG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAGD;;OAEG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAGD;;OAEG;IACI,OAAO,CAAC,KAAQ;QACnB,IAAI,IAAI,CAAC,YAAY,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;SACzC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAGD;;OAEG;IACI,MAAM,CAAC,KAAQ;QAClB,IAAI,IAAI,CAAC,YAAY,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;SACzC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;CAEJ;AA7DD,4BA6DC"}
+{"version":3,"file":"deferred.js","sourceRoot":"","sources":["../src/deferred.ts"],"names":[],"mappings":";;;AAAA,MAAa,QAAQ;IACjB;QAiBQ,iBAAY,GAAG,KAAK,CAAC;QAQrB,gBAAW,GAAG,KAAK,CAAC;QAQpB,gBAAW,GAAG,KAAK,CAAC;QAhCxB,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC/C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QAC1B,CAAC,CAAC,CAAC;IACP,CAAC;IACD,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAGD;;OAEG;IACH,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAGD;;OAEG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAGD;;OAEG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAGD;;OAEG;IACI,OAAO,CAAC,KAAS;QACpB,IAAI,IAAI,CAAC,YAAY,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;SACzC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAGM,UAAU,CAAC,KAAS;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SACvB;IACL,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAc;QACxB,IAAI,IAAI,CAAC,YAAY,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;SACzC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAGM,SAAS,CAAC,MAAgB;QAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YACnB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;SACvB;IACL,CAAC;CACJ;AAzED,4BAyEC"}

package/dist/diagnosticUtils.d.ts

@@ -1,7 +1,15 @@
 import type { Chalk } from 'chalk';
-import type { BsConfig } from './BsConfig';
+import type { BsConfig, DiagnosticReporter, NormalizedDiagnosticReporter } from './BsConfig';
 import { DiagnosticSeverity } from 'vscode-languageserver';
-import type { BsDiagnostic } from '.';
+import type { BsDiagnostic } from './interfaces';
+import type { Range } from 'vscode-languageserver';
+export declare const MAX_RELATED_INFOS_COUNT = 3;
+/**
+ * The set of placeholder names recognized inside a custom diagnostic reporter template.
+ * `buildDiagnosticPlaceholders` is typed against this list, so adding a name here will
+ * cause a compile error until the corresponding value is supplied (and vice versa).
+ */
+export declare const KNOWN_DIAGNOSTIC_TEMPLATE_PLACEHOLDERS: readonly ["file", "line", "col", "endLine", "endCol", "severity", "severityCode", "code", "message", "source"];
 /**
  * Prepare print diagnostic formatting options
  */
@@ -13,11 +21,60 @@ export declare function getPrintDiagnosticOptions(options: BsConfig): {
     typeColor: Record<string, Chalk>;
     severityTextMap: {};
 };
+/**
+ * Resolve a `DiagnosticReporter` value (or array of them) into the array of object-form
+ * reporters used by the printer.
+ *
+ * Behavior:
+ *   - missing/null value → default `[{ type: 'detailed' }]`
+ *   - explicit empty array → preserved (caller has opted out of all output)
+ *   - invalid entry inside a non-empty input → warned via `logger`, skipped
+ *   - duplicate entry (same preset type, or same custom-template format string) → warned, skipped
+ *   - all entries invalid → warned, falls back to `[{ type: 'detailed' }]`
+ *
+ * Bad reporters never throw, surfacing a typo shouldn't be able to abort a build.
+ */
+export declare function normalizeDiagnosticReporters(value: DiagnosticReporter | DiagnosticReporter[] | undefined, logger?: {
+    warn(...messages: any[]): void;
+}): NormalizedDiagnosticReporter[];
 /**
  * Format output of one diagnostic
  */
-export declare function printDiagnostic(options: ReturnType<typeof getPrintDiagnosticOptions>, severity: DiagnosticSeverity, filePath: string, lines: string[], diagnostic: BsDiagnostic): void;
+export declare function printDiagnostic(options: ReturnType<typeof getPrintDiagnosticOptions>, severity: DiagnosticSeverity, filePath: string | undefined, lines: string[], diagnostic: BsDiagnostic, relatedInformation?: Array<{
+    range: Range;
+    filePath: string;
+    message: string;
+}>): void;
+export declare function getDiagnosticLine(diagnostic: BsDiagnostic, diagnosticLine: string, colorFunction: Chalk): string;
 /**
  * Given a diagnostic, compute the range for the squiggly
  */
-export declare function getDiagnosticSquigglyText(diagnostic: BsDiagnostic, line: string): string;
+export declare function getDiagnosticSquigglyText(line: string | undefined, startCharacter: number | undefined, endCharacter: number | undefined): string;
+/**
+ * Substitute `{name}` placeholders in `template` using the given values.
+ * Only known placeholder names are matched; anything else (typos like `{filename}`
+ * or unrelated braces in user text) passes through unchanged.
+ */
+export declare function applyDiagnosticTemplate(template: string, values: Record<string, string>): string;
+/**
+ * Print one diagnostic in GitHub Actions workflow command format so the
+ * runner surfaces it as a PR annotation.
+ */
+export declare function printDiagnosticGithubActions(ctx: DiagnosticPrintContext): void;
+/**
+ * Build a reporter that renders each diagnostic via the given user-supplied template.
+ * See `BsConfig.diagnosticReporters` for the placeholder list.
+ */
+export declare function createCustomDiagnosticReporter(template: string): DiagnosticReporterFn;
+/**
+ * Context passed to the object-shaped diagnostic reporters
+ * (`printDiagnosticGithubActions`, custom-template reporters).
+ * The detailed reporter has its own positional signature for backward compatibility.
+ */
+export interface DiagnosticPrintContext {
+    options: ReturnType<typeof getPrintDiagnosticOptions>;
+    severity: DiagnosticSeverity;
+    filePath: string | undefined;
+    diagnostic: BsDiagnostic;
+}
+export declare type DiagnosticReporterFn = (ctx: DiagnosticPrintContext) => void;