@actions/languageservice 0.2.0

package/dist/context-providers/matrix.js

@@ -0,0 +1,163 @@
+import { data, DescriptionDictionary } from "@actions/expressions";
+import { isBasicExpression, isMapping, isSequence, isString } from "@actions/workflow-parser";
+import { Mode } from "./default";
+export function getMatrixContext(workflowContext, mode) {
+    // https://docs.github.com/en/actions/learn-github-actions/contexts#matrix-context
+    const strategy = workflowContext.job?.strategy ?? workflowContext.reusableWorkflowJob?.strategy;
+    if (!strategy || !isMapping(strategy)) {
+        return new DescriptionDictionary();
+    }
+    const matrix = strategy.find("matrix");
+    if (!matrix || !isMapping(matrix)) {
+        // Matrix could be an expression, so there's no context we can provide
+        return new data.Null();
+    }
+    const properties = matrixProperties(matrix, mode);
+    if (!properties) {
+        // Matrix included an expression, so there's no context we can provide
+        return new data.Null();
+    }
+    const d = new DescriptionDictionary();
+    for (const [key, value] of properties) {
+        if (value === undefined) {
+            d.add(key, new data.Null());
+            continue;
+        }
+        const a = new data.Array();
+        for (const v of value) {
+            a.add(new data.StringData(v));
+        }
+        d.add(key, a);
+    }
+    return d;
+}
+/**
+ * https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix
+ * A matrix property can come from:
+ *   - An explicit matrix property key
+ *   - A configuration included via the "include" property
+ *
+ * By definition, "exclude" can't add new keys to the matrix.
+ * Additionally, "include" and "exclude are not properties of the matrix
+ * If the matrix or "include" is an expression, we can't know the keys
+ *
+ * Examples:
+ * 1. Basic matrix
+ *   matrix:
+ *     version: [10, 12, 14]
+ *     os: [ubuntu-latest, windows-latest]
+ *
+ *   Keys: version, os
+ *
+ * 2. Matrix with "include"
+ *   matrix:
+ *     version: [10, 12, 14]
+ *     os: [ubuntu-latest, windows-latest]
+ *     include:
+ *       - version: 10
+ *         os: macos-latest
+ *
+ *   Keys: version, os
+ *
+ * 3. Matrix with new properties in "include"
+ *   matrix:
+ *     include:
+ *     - site: "production"
+ *       datacenter: "site-a"
+ *     - site: "staging"
+ *       datacenter: "site-b"
+ *
+ *   Keys: site, datacenter
+ *
+ * 4. Matrix with "exclude"
+ *   matrix:
+ *     os: [macos-latest, windows-latest]
+ *     version: [12, 14, 16]
+ *     environment: [staging, production]
+ *     exclude:
+ *       - os: macos-latest
+ *         version: 12
+ *         environment: production
+ *       - os: windows-latest
+ *         version: 16
+ *
+ *  Keys: os, version, environment
+ */
+function matrixProperties(matrix, mode) {
+    const properties = new Map();
+    let include;
+    for (const pair of matrix) {
+        if (!isString(pair.key)) {
+            continue;
+        }
+        const key = pair.key.value;
+        switch (key) {
+            case "include":
+                // If "include" is an expression, we can't know the full properties of the matrix
+                if (isBasicExpression(pair.value) || !isSequence(pair.value)) {
+                    // Without the full properties of the matrix, we shouldn't validate anything
+                    if (mode === Mode.Validation) {
+                        return;
+                    }
+                    else {
+                        continue;
+                    }
+                }
+                include = pair.value;
+                break;
+            case "exclude":
+                break;
+            default: {
+                if (!isSequence(pair.value)) {
+                    properties.set(key, undefined);
+                    continue;
+                }
+                const values = new Set();
+                for (const value of pair.value) {
+                    // The parser should coerce matrix values to strings, ignore expressions
+                    if (isString(value)) {
+                        values.add(value.value);
+                    }
+                }
+                properties.set(key, values);
+                break;
+            }
+        }
+    }
+    if (include) {
+        for (const item of include) {
+            if (!isMapping(item)) {
+                continue;
+            }
+            for (const pair of item) {
+                addValueToProperties(properties, pair);
+            }
+        }
+    }
+    return properties;
+}
+function addValueToProperties(properties, pair) {
+    if (!isString(pair.key)) {
+        return;
+    }
+    const key = pair.key.value;
+    const value = isString(pair.value) ? pair.value.value : undefined;
+    if (!properties.has(key)) {
+        if (value === undefined) {
+            properties.set(key, undefined);
+            return;
+        }
+        properties.set(key, new Set([value]));
+        return;
+    }
+    if (value === undefined) {
+        return;
+    }
+    const property = properties.get(key);
+    if (property !== undefined) {
+        property.add(value);
+        return;
+    }
+    properties.set(key, new Set([value]));
+}
+//# sourceMappingURL=matrix.js.map

package/dist/context-providers/matrix.js.map

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

package/dist/context-providers/needs.d.ts

@@ -0,0 +1,4 @@
+import { DescriptionDictionary } from "@actions/expressions";
+import { WorkflowContext } from "../context/workflow-context";
+export declare function getNeedsContext(workflowContext: WorkflowContext): DescriptionDictionary;
+//# sourceMappingURL=needs.d.ts.map

package/dist/context-providers/needs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"needs.d.ts","sourceRoot":"","sources":["../../src/context-providers/needs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAKjE,OAAO,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAC;AAE5D,wBAAgB,eAAe,CAAC,eAAe,EAAE,eAAe,GAAG,qBAAqB,CAevF"}

package/dist/context-providers/needs.js

@@ -0,0 +1,56 @@
+import { data, DescriptionDictionary } from "@actions/expressions";
+import { isMapping, isScalar, isString } from "@actions/workflow-parser";
+import { isJob } from "@actions/workflow-parser/model/type-guards";
+export function getNeedsContext(workflowContext) {
+    const d = new DescriptionDictionary();
+    const job = workflowContext.job || workflowContext.reusableWorkflowJob;
+    if (!job?.needs) {
+        return d;
+    }
+    for (const jobID of job.needs) {
+        const job = workflowContext.template?.jobs.find(job => job.id.value === jobID.value);
+        d.add(jobID.value, needsJobContext(job));
+    }
+    return d;
+}
+function needsJobContext(job) {
+    // https://docs.github.com/en/actions/learn-github-actions/contexts#needs-context
+    const d = new DescriptionDictionary();
+    if (job) {
+        d.add("outputs", jobOutputs(job));
+    }
+    // Can be "success", "failure", "cancelled", or "skipped"
+    d.add("result", new data.Null());
+    return d;
+}
+function jobOutputs(job) {
+    const d = new DescriptionDictionary();
+    if (!job?.outputs) {
+        return d;
+    }
+    for (const output of job.outputs) {
+        if (!isString(output.key)) {
+            continue;
+        }
+        d.add(output.key.value, ...jobOutput(job, output.value));
+    }
+    return d;
+}
+function jobOutput(job, outputValue) {
+    if (isJob(job)) {
+        // A regular workflow job won't have a description
+        return isScalar(outputValue)
+            ? [new data.StringData(outputValue.toDisplayString()), undefined]
+            : [new data.Null(), undefined];
+    }
+    if (!isMapping(outputValue)) {
+        return [new data.Null(), undefined];
+    }
+    const description = outputValue.find("description");
+    const value = outputValue.find("value");
+    return [
+        value && isScalar(value) ? new data.StringData(value.toDisplayString()) : new data.Null(),
+        description && isString(description) ? description.value : undefined
+    ];
+}
+//# sourceMappingURL=needs.js.map

package/dist/context-providers/needs.js.map

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

package/dist/context-providers/secrets.d.ts

@@ -0,0 +1,5 @@
+import { DescriptionDictionary } from "@actions/expressions";
+import { WorkflowContext } from "../context/workflow-context";
+import { Mode } from "./default";
+export declare function getSecretsContext(workflowContext: WorkflowContext, mode: Mode): DescriptionDictionary;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/context-providers/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/context-providers/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAG/B,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,GAAG,qBAAqB,CAmBrG"}

package/dist/context-providers/secrets.js

@@ -0,0 +1,23 @@
+import { data, DescriptionDictionary } from "@actions/expressions";
+import { StringData } from "@actions/expressions/data/string";
+import { Mode } from "./default";
+import { getDescription } from "./descriptions";
+export function getSecretsContext(workflowContext, mode) {
+    const d = new DescriptionDictionary({
+        key: "GITHUB_TOKEN",
+        value: new data.StringData("***"),
+        description: getDescription("secrets", "GITHUB_TOKEN")
+    });
+    const eventsConfig = workflowContext?.template?.events;
+    if (eventsConfig?.workflow_call) {
+        // Unpredictable secrets may be passed in via a workflow_call trigger
+        d.complete = false;
+        if (mode === Mode.Completion) {
+            for (const [name, value] of Object.entries(eventsConfig.workflow_call.secrets || {})) {
+                d.add(name, new StringData(""), value.description);
+            }
+        }
+    }
+    return d;
+}
+//# sourceMappingURL=secrets.js.map

package/dist/context-providers/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/context-providers/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAC,UAAU,EAAC,MAAM,kCAAkC,CAAC;AAE5D,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAC;AAE9C,MAAM,UAAU,iBAAiB,CAAC,eAAgC,EAAE,IAAU;IAC5E,MAAM,CAAC,GAAG,IAAI,qBAAqB,CAAC;QAClC,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QACjC,WAAW,EAAE,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC;KACvD,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC;IACvD,IAAI,YAAY,EAAE,aAAa,EAAE;QAC/B,qEAAqE;QACrE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;QACnB,IAAI,IAAI,KAAK,IAAI,CAAC,UAAU,EAAE;YAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;gBACpF,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;aACpD;SACF;KACF;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/context-providers/steps.d.ts

@@ -0,0 +1,4 @@
+import { DescriptionDictionary } from "@actions/expressions";
+import { WorkflowContext } from "../context/workflow-context";
+export declare function getStepsContext(workflowContext: WorkflowContext): DescriptionDictionary;
+//# sourceMappingURL=steps.d.ts.map

package/dist/context-providers/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/context-providers/steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAC;AAG5D,wBAAgB,eAAe,CAAC,eAAe,EAAE,eAAe,GAAG,qBAAqB,CAsBvF"}

package/dist/context-providers/steps.js

@@ -0,0 +1,35 @@
+import { data, DescriptionDictionary } from "@actions/expressions";
+import { getDescription } from "./descriptions";
+export function getStepsContext(workflowContext) {
+    const d = new DescriptionDictionary();
+    if (!workflowContext.job?.steps) {
+        return d;
+    }
+    const currentStep = workflowContext.step?.id;
+    for (const step of workflowContext.job.steps) {
+        // We can't reference context from the current step or later steps
+        if (currentStep && step.id === currentStep) {
+            break;
+        }
+        if (isGenerated(step)) {
+            continue;
+        }
+        d.add(step.id, stepContext());
+    }
+    return d;
+}
+function stepContext() {
+    // https://docs.github.com/en/actions/learn-github-actions/contexts#steps-context
+    const d = new DescriptionDictionary();
+    d.add("outputs", new data.Null(), getDescription("steps", "outputs"));
+    // Can be "success", "failure", "cancelled", or "skipped"
+    d.add("conclusion", new data.Null(), getDescription("steps", "conclusion"));
+    d.add("outcome", new data.Null(), getDescription("steps", "outcome"));
+    return d;
+}
+function isGenerated(step) {
+    // Steps need to explicitly set an ID to be referenced in the context
+    // Generated IDs always start with "__", which is not allowed by user-defined IDs
+    return step.id.startsWith("__");
+}
+//# sourceMappingURL=steps.js.map

package/dist/context-providers/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/context-providers/steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAGjE,OAAO,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAC;AAE9C,MAAM,UAAU,eAAe,CAAC,eAAgC;IAC9D,MAAM,CAAC,GAAG,IAAI,qBAAqB,EAAE,CAAC;IACtC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE;QAC/B,OAAO,CAAC,CAAC;KACV;IAED,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE;QAC5C,kEAAkE;QAClE,IAAI,WAAW,IAAI,IAAI,CAAC,EAAE,KAAK,WAAW,EAAE;YAC1C,MAAM;SACP;QAED,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE;YACrB,SAAS;SACV;QAED,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;KAC/B;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,WAAW;IAClB,iFAAiF;IACjF,MAAM,CAAC,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAEtC,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAEtE,yDAAyD;IACzD,CAAC,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAEtE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,IAAU;IAC7B,qEAAqE;IACrE,iFAAiF;IACjF,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/context-providers/strategy.d.ts

@@ -0,0 +1,4 @@
+import { DescriptionDictionary } from "@actions/expressions";
+import { WorkflowContext } from "../context/workflow-context";
+export declare function getStrategyContext(workflowContext: WorkflowContext): DescriptionDictionary;
+//# sourceMappingURL=strategy.d.ts.map

package/dist/context-providers/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../src/context-providers/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAC;AAG5D,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,eAAe,GAAG,qBAAqB,CAiC1F"}

package/dist/context-providers/strategy.js

@@ -0,0 +1,31 @@
+import { data, DescriptionDictionary } from "@actions/expressions";
+import { isMapping, isScalar, isString } from "@actions/workflow-parser";
+import { scalarToData } from "../utils/scalar-to-data";
+export function getStrategyContext(workflowContext) {
+    // https://docs.github.com/en/actions/learn-github-actions/contexts#strategy-context
+    const keys = ["fail-fast", "job-index", "job-total", "max-parallel"];
+    const strategy = workflowContext.job?.strategy ?? workflowContext.reusableWorkflowJob?.strategy;
+    if (!strategy || !isMapping(strategy)) {
+        return new DescriptionDictionary(...keys.map(key => {
+            return { key, value: new data.Null() };
+        }));
+    }
+    const strategyContext = new DescriptionDictionary();
+    for (const pair of strategy) {
+        if (!isString(pair.key)) {
+            continue;
+        }
+        if (!keys.includes(pair.key.value)) {
+            continue;
+        }
+        const value = isScalar(pair.value) ? scalarToData(pair.value) : new data.Null();
+        strategyContext.add(pair.key.value, value);
+    }
+    for (const key of keys) {
+        if (!strategyContext.get(key)) {
+            strategyContext.add(key, new data.Null());
+        }
+    }
+    return strategyContext;
+}
+//# sourceMappingURL=strategy.js.map

package/dist/context-providers/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../src/context-providers/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAC;AAErD,MAAM,UAAU,kBAAkB,CAAC,eAAgC;IACjE,oFAAoF;IACpF,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IAErE,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,EAAE,QAAQ,IAAI,eAAe,CAAC,mBAAmB,EAAE,QAAQ,CAAC;IAChG,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;QACrC,OAAO,IAAI,qBAAqB,CAC9B,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAChB,OAAO,EAAC,GAAG,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,EAAC,CAAC;QACvC,CAAC,CAAC,CACH,CAAC;KACH;IAED,MAAM,eAAe,GAAG,IAAI,qBAAqB,EAAE,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE;QAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YACvB,SAAS;SACV;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YAClC,SAAS;SACV;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAChF,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;KAC5C;IAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;QACtB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAC7B,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;SAC3C;KACF;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/description-providers/reusable-job-inputs.d.ts

@@ -0,0 +1,5 @@
+import { WorkflowContext } from "../context/workflow-context";
+import { TokenResult } from "../utils/find-token";
+export declare function isReusableWorkflowJobInput(tokenResult: TokenResult): boolean;
+export declare function getReusableWorkflowInputDescription(workflowContext: WorkflowContext, tokenResult: TokenResult): string;
+//# sourceMappingURL=reusable-job-inputs.d.ts.map

package/dist/description-providers/reusable-job-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reusable-job-inputs.d.ts","sourceRoot":"","sources":["../../src/description-providers/reusable-job-inputs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,eAAe,EAAC,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAEhD,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAM5E;AAED,wBAAgB,mCAAmC,CACjD,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,WAAW,GACvB,MAAM,CAwBR"}

package/dist/description-providers/reusable-job-inputs.js

@@ -0,0 +1,29 @@
+import { isMapping, isString } from "@actions/workflow-parser";
+import { DESCRIPTION } from "@actions/workflow-parser/templates/template-constants";
+export function isReusableWorkflowJobInput(tokenResult) {
+    return (tokenResult.parent?.definition?.key === "workflow-job-with" &&
+        tokenResult.token !== null &&
+        isString(tokenResult.token));
+}
+export function getReusableWorkflowInputDescription(workflowContext, tokenResult) {
+    const reusableWorkflowJob = workflowContext.reusableWorkflowJob;
+    if (!reusableWorkflowJob) {
+        return "";
+    }
+    const inputName = tokenResult.token && isString(tokenResult.token) && tokenResult.token.value;
+    if (!inputName) {
+        return "";
+    }
+    // Find the input description in the template, if any
+    if (reusableWorkflowJob["input-definitions"]) {
+        const definition = reusableWorkflowJob["input-definitions"].find(inputName);
+        if (definition && isMapping(definition)) {
+            const description = definition.find(DESCRIPTION);
+            if (description && isString(description)) {
+                return description.value;
+            }
+        }
+    }
+    return "";
+}
+//# sourceMappingURL=reusable-job-inputs.js.map

package/dist/description-providers/reusable-job-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reusable-job-inputs.js","sourceRoot":"","sources":["../../src/description-providers/reusable-job-inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAC,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAC,WAAW,EAAC,MAAM,uDAAuD,CAAC;AAIlF,MAAM,UAAU,0BAA0B,CAAC,WAAwB;IACjE,OAAO,CACL,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,mBAAmB;QAC3D,WAAW,CAAC,KAAK,KAAK,IAAI;QAC1B,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,eAAgC,EAChC,WAAwB;IAExB,MAAM,mBAAmB,GAAG,eAAe,CAAC,mBAAmB,CAAC;IAEhE,IAAI,CAAC,mBAAmB,EAAE;QACxB,OAAO,EAAE,CAAC;KACX;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,IAAI,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;IAC9F,IAAI,CAAC,SAAS,EAAE;QACd,OAAO,EAAE,CAAC;KACX;IAED,qDAAqD;IACrD,IAAI,mBAAmB,CAAC,mBAAmB,CAAC,EAAE;QAC5C,MAAM,UAAU,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5E,IAAI,UAAU,IAAI,SAAS,CAAC,UAAU,CAAC,EAAE;YACvC,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACjD,IAAI,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,EAAE;gBACxC,OAAO,WAAW,CAAC,KAAK,CAAC;aAC1B;SACF;KACF;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/document-links.d.ts

@@ -0,0 +1,4 @@
+import { TextDocument } from "vscode-languageserver-textdocument";
+import { DocumentLink } from "vscode-languageserver-types";
+export declare function documentLinks(document: TextDocument, workspace: string | undefined): Promise<DocumentLink[]>;
+//# sourceMappingURL=document-links.d.ts.map

package/dist/document-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-links.d.ts","sourceRoot":"","sources":["../src/document-links.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAC,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC;AAMzD,wBAAsB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA8ElH"}

package/dist/document-links.js

@@ -0,0 +1,73 @@
+import { ErrorPolicy } from "@actions/workflow-parser/model/convert";
+import { isJob, isReusableWorkflowJob } from "@actions/workflow-parser/model/type-guards";
+import { parseFileReference } from "@actions/workflow-parser/workflows/file-reference";
+import vscodeURI from "vscode-uri/lib/umd"; // work around issues with the vscode-uri package
+import { actionUrl, parseActionReference } from "./action";
+import { mapRange } from "./utils/range";
+import { fetchOrConvertWorkflowTemplate, fetchOrParseWorkflow } from "./utils/workflow-cache";
+export async function documentLinks(document, workspace) {
+    const file = {
+        name: document.uri,
+        content: document.getText()
+    };
+    const parsedWorkflow = fetchOrParseWorkflow(file, document.uri);
+    if (!parsedWorkflow?.value) {
+        return [];
+    }
+    const template = await fetchOrConvertWorkflowTemplate(parsedWorkflow.context, parsedWorkflow.value, document.uri, undefined, {
+        errorPolicy: ErrorPolicy.TryConversion
+    });
+    const links = [];
+    for (const job of template?.jobs || []) {
+        if (!job) {
+            continue;
+        }
+        if (isJob(job)) {
+            // Add links to referenced actions
+            for (const step of job.steps || []) {
+                if ("uses" in step) {
+                    const actionRef = parseActionReference(step.uses.value);
+                    if (!actionRef) {
+                        continue;
+                    }
+                    const url = actionUrl(actionRef);
+                    links.push({
+                        range: mapRange(step.uses.range),
+                        target: url,
+                        tooltip: `Open action on GitHub`
+                    });
+                }
+            }
+        }
+        else if (isReusableWorkflowJob(job)) {
+            // Add links to referenced reusable workflows
+            const ref = parseFileReference(job.ref.value);
+            if ("repository" in ref) {
+                // Remote workflow
+                const url = actionUrl({
+                    owner: ref.owner,
+                    name: ref.repository,
+                    path: ref.path,
+                    ref: ref.version
+                });
+                links.push({
+                    range: mapRange(job.ref.range),
+                    target: url,
+                    tooltip: `Open reusable workflow on GitHub`
+                });
+            }
+            else if (workspace) {
+                // We need workspace information to generate this link
+                // Local workflow, generate workspace link
+                const workspaceURI = vscodeURI.URI.parse(workspace);
+                const refURI = vscodeURI.Utils.joinPath(workspaceURI, job.ref.value);
+                links.push({
+                    range: mapRange(job.ref.range),
+                    target: refURI.toString()
+                });
+            }
+        }
+    }
+    return [...links];
+}
+//# sourceMappingURL=document-links.js.map

package/dist/document-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-links.js","sourceRoot":"","sources":["../src/document-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,wCAAwC,CAAC;AACnE,OAAO,EAAC,KAAK,EAAE,qBAAqB,EAAC,MAAM,4CAA4C,CAAC;AAExF,OAAO,EAAC,kBAAkB,EAAC,MAAM,mDAAmD,CAAC;AAGrF,OAAO,SAAS,MAAM,oBAAoB,CAAC,CAAC,iDAAiD;AAC7F,OAAO,EAAC,SAAS,EAAE,oBAAoB,EAAC,MAAM,UAAU,CAAC;AACzD,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,EAAC,8BAA8B,EAAE,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAE5F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAsB,EAAE,SAA6B;IACvF,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,QAAQ,CAAC,GAAG;QAClB,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;KAC5B,CAAC;IAEF,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChE,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE;QAC1B,OAAO,EAAE,CAAC;KACX;IAED,MAAM,QAAQ,GAAG,MAAM,8BAA8B,CACnD,cAAc,CAAC,OAAO,EACtB,cAAc,CAAC,KAAK,EACpB,QAAQ,CAAC,GAAG,EACZ,SAAS,EACT;QACE,WAAW,EAAE,WAAW,CAAC,aAAa;KACvC,CACF,CAAC;IAEF,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,IAAI,IAAI,EAAE,EAAE;QACtC,IAAI,CAAC,GAAG,EAAE;YACR,SAAS;SACV;QAED,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE;YACd,kCAAkC;YAClC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE;gBAClC,IAAI,MAAM,IAAI,IAAI,EAAE;oBAClB,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACxD,IAAI,CAAC,SAAS,EAAE;wBACd,SAAS;qBACV;oBAED,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;oBAEjC,KAAK,CAAC,IAAI,CAAC;wBACT,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;wBAChC,MAAM,EAAE,GAAG;wBACX,OAAO,EAAE,uBAAuB;qBACjC,CAAC,CAAC;iBACJ;aACF;SACF;aAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE;YACrC,6CAA6C;YAC7C,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,YAAY,IAAI,GAAG,EAAE;gBACvB,kBAAkB;gBAClB,MAAM,GAAG,GAAG,SAAS,CAAC;oBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,IAAI,EAAE,GAAG,CAAC,UAAU;oBACpB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,GAAG,EAAE,GAAG,CAAC,OAAO;iBACjB,CAAC,CAAC;gBAEH,KAAK,CAAC,IAAI,CAAC;oBACT,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;oBAC9B,MAAM,EAAE,GAAG;oBACX,OAAO,EAAE,kCAAkC;iBAC5C,CAAC,CAAC;aACJ;iBAAM,IAAI,SAAS,EAAE;gBACpB,sDAAsD;gBACtD,0CAA0C;gBAC1C,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACpD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAErE,KAAK,CAAC,IAAI,CAAC;oBACT,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;oBAC9B,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;iBAC1B,CAAC,CAAC;aACJ;SACF;KACF;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/expression-hover/expression-pos.d.ts

@@ -0,0 +1,13 @@
+import { Pos } from "@actions/expressions/lexer";
+import { TemplateToken } from "@actions/workflow-parser/templates/tokens/template-token";
+import { Position, Range as LSPRange } from "vscode-languageserver-textdocument";
+export type ExpressionPos = {
+    /** The expression that includes the position */
+    expression: string;
+    /** Adjusted position, pointing into the expression */
+    position: Pos;
+    /** Range of the expression in the document */
+    documentRange: LSPRange;
+};
+export declare function mapToExpressionPos(token: TemplateToken, position: Position): ExpressionPos | undefined;
+//# sourceMappingURL=expression-pos.d.ts.map

package/dist/expression-hover/expression-pos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-pos.d.ts","sourceRoot":"","sources":["../../src/expression-hover/expression-pos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,4BAA4B,CAAC;AAC/C,OAAO,EAAC,aAAa,EAAC,MAAM,0DAA0D,CAAC;AAEvF,OAAO,EAAC,QAAQ,EAAE,KAAK,IAAI,QAAQ,EAAC,MAAM,oCAAoC,CAAC;AAI/E,MAAM,MAAM,aAAa,GAAG;IAC1B,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IAEnB,sDAAsD;IACtD,QAAQ,EAAE,GAAG,CAAC;IAEd,8CAA8C;IAC9C,aAAa,EAAE,QAAQ,CAAC;CACzB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,CAyCtG"}

package/dist/expression-hover/expression-pos.js

@@ -0,0 +1,41 @@
+import { isBasicExpression } from "@actions/workflow-parser/templates/tokens/type-guards";
+import { mapRange } from "../utils/range";
+import { posWithinRange } from "./pos-range";
+export function mapToExpressionPos(token, position) {
+    const pos = {
+        line: position.line + 1,
+        column: position.character + 1
+    };
+    if (!isBasicExpression(token)) {
+        return undefined;
+    }
+    if (token.originalExpressions?.length) {
+        for (const originalExp of token.originalExpressions) {
+            // Find the original expression that contains the position
+            if (originalExp.expressionRange && posWithinRange(pos, originalExp.expressionRange)) {
+                const exprRange = mapRange(originalExp.expressionRange);
+                return {
+                    expression: originalExp.expression,
+                    // Adjust the position to point into the expression
+                    position: {
+                        line: pos.line - exprRange.start.line - 1,
+                        column: pos.column - exprRange.start.character - 1
+                    },
+                    documentRange: exprRange
+                };
+            }
+        }
+        return undefined;
+    }
+    const exprRange = mapRange(token.expressionRange);
+    return {
+        expression: token.expression,
+        // Adjust the position to point into the expression
+        position: {
+            line: pos.line - exprRange.start.line - 1,
+            column: pos.column - exprRange.start.character - 1
+        },
+        documentRange: exprRange
+    };
+}
+//# sourceMappingURL=expression-pos.js.map

package/dist/expression-hover/expression-pos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-pos.js","sourceRoot":"","sources":["../../src/expression-hover/expression-pos.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,iBAAiB,EAAC,MAAM,uDAAuD,CAAC;AAExF,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAa3C,MAAM,UAAU,kBAAkB,CAAC,KAAoB,EAAE,QAAkB;IACzE,MAAM,GAAG,GAAQ;QACf,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC;QACvB,MAAM,EAAE,QAAQ,CAAC,SAAS,GAAG,CAAC;KAC/B,CAAC;IAEF,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE;QAC7B,OAAO,SAAS,CAAC;KAClB;IAED,IAAI,KAAK,CAAC,mBAAmB,EAAE,MAAM,EAAE;QACrC,KAAK,MAAM,WAAW,IAAI,KAAK,CAAC,mBAAmB,EAAE;YACnD,0DAA0D;YAC1D,IAAI,WAAW,CAAC,eAAe,IAAI,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,eAAe,CAAC,EAAE;gBACnF,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;gBAExD,OAAO;oBACL,UAAU,EAAE,WAAW,CAAC,UAAU;oBAClC,mDAAmD;oBACnD,QAAQ,EAAE;wBACR,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;wBACzC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC;qBACnD;oBACD,aAAa,EAAE,SAAS;iBACzB,CAAC;aACH;SACF;QAED,OAAO,SAAS,CAAC;KAClB;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAClD,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,mDAAmD;QACnD,QAAQ,EAAE;YACR,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;YACzC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC;SACnD;QACD,aAAa,EAAE,SAAS;KACzB,CAAC;AACJ,CAAC"}

package/dist/expression-hover/pos-range.d.ts

@@ -0,0 +1,3 @@
+import { Pos, Range } from "@actions/expressions/lexer";
+export declare function posWithinRange(pos: Pos, range: Range): boolean;
+//# sourceMappingURL=pos-range.d.ts.map

package/dist/expression-hover/pos-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pos-range.d.ts","sourceRoot":"","sources":["../../src/expression-hover/pos-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAE,KAAK,EAAC,MAAM,4BAA4B,CAAC;AAEtD,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAO9D"}

package/dist/expression-hover/pos-range.js

@@ -0,0 +1,7 @@
+export function posWithinRange(pos, range) {
+    return (pos.line >= range.start.line &&
+        pos.line <= range.end.line &&
+        pos.column >= range.start.column &&
+        pos.column <= range.end.column);
+}
+//# sourceMappingURL=pos-range.js.map

package/dist/expression-hover/pos-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pos-range.js","sourceRoot":"","sources":["../../src/expression-hover/pos-range.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,KAAY;IACnD,OAAO,CACL,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI;QAC5B,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI;QAC1B,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM;QAChC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAC/B,CAAC;AACJ,CAAC"}

package/dist/expression-hover/visitor.d.ts

@@ -0,0 +1,27 @@
+import { DescriptionDictionary } from "@actions/expressions";
+import { Binary, ContextAccess, Expr, ExprVisitor, FunctionCall, Grouping, IndexAccess, Logical, Unary } from "@actions/expressions/ast";
+import { FunctionDefinition } from "@actions/expressions/funcs/info";
+import { Pos, Range } from "@actions/expressions/lexer";
+export type HoverResult = undefined | {
+    label: string;
+    description?: string;
+    function: boolean;
+    range: Range;
+};
+export declare class HoverVisitor implements ExprVisitor<HoverResult> {
+    private pos;
+    private context;
+    private functions;
+    private ignorePosCheck;
+    constructor(pos: Pos, context: DescriptionDictionary, functions: Map<string, FunctionDefinition>);
+    hover(n: Expr): HoverResult;
+    visitLiteral(): HoverResult;
+    visitUnary(unary: Unary): HoverResult;
+    visitBinary(binary: Binary): HoverResult;
+    visitLogical(logical: Logical): HoverResult;
+    visitGrouping(grouping: Grouping): HoverResult;
+    visitContextAccess(contextAccess: ContextAccess): HoverResult;
+    visitIndexAccess(indexAccess: IndexAccess): HoverResult;
+    visitFunctionCall(functionCall: FunctionCall): HoverResult;
+}
+//# sourceMappingURL=visitor.d.ts.map