@actions/languageservice 0.3.30 → 0.3.31

package/dist/document-links.js

@@ -3,18 +3,63 @@ import { isJob, isReusableWorkflowJob } from "@actions/workflow-parser/model/typ
 import { parseFileReference } from "@actions/workflow-parser/workflows/file-reference";
 import * as vscodeURI from "vscode-uri";
 import { actionUrl, parseActionReference } from "./action.js";
+import { isActionDocument } from "./utils/document-type.js";
 import { mapRange } from "./utils/range.js";
-import { fetchOrConvertWorkflowTemplate, fetchOrParseWorkflow } from "./utils/workflow-cache.js";
+import { getOrConvertActionTemplate, getOrConvertWorkflowTemplate, getOrParseAction, getOrParseWorkflow } from "./utils/workflow-cache.js";
+/**
+ * Generates clickable links for action references and reusable workflows.
+ */
 export async function documentLinks(document, workspace) {
     const file = {
         name: document.uri,
         content: document.getText()
     };
-    const parsedWorkflow = fetchOrParseWorkflow(file, document.uri);
+    return isActionDocument(document.uri)
+        ? actionDocumentLinks(file, document.uri)
+        : workflowDocumentLinks(file, document.uri, workspace);
+}
+/**
+ * Generates clickable links for action references in action.yml files.
+ */
+function actionDocumentLinks(file, uri) {
+    const parsedAction = getOrParseAction(file, uri);
+    if (!parsedAction?.value) {
+        return [];
+    }
+    const template = getOrConvertActionTemplate(parsedAction.context, parsedAction.value, uri, {
+        errorPolicy: ErrorPolicy.TryConversion
+    });
+    const links = [];
+    // Only composite actions have steps
+    if (template?.runs?.using !== "composite") {
+        return links;
+    }
+    const steps = template.runs.steps ?? [];
+    for (const step of 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`
+            });
+        }
+    }
+    return links;
+}
+/**
+ * Generates clickable links for action references and reusable workflows in workflow files.
+ */
+async function workflowDocumentLinks(file, uri, workspace) {
+    const parsedWorkflow = getOrParseWorkflow(file, uri);
     if (!parsedWorkflow?.value) {
         return [];
     }
-    const template = await fetchOrConvertWorkflowTemplate(parsedWorkflow.context, parsedWorkflow.value, document.uri, undefined, {
+    const template = await getOrConvertWorkflowTemplate(parsedWorkflow.context, parsedWorkflow.value, uri, undefined, {
         errorPolicy: ErrorPolicy.TryConversion
     });
     const links = [];

package/dist/document-links.js.map

@@ -1 +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,KAAK,SAAS,MAAM,YAAY,CAAC;AACxC,OAAO,EAAC,SAAS,EAAE,oBAAoB,EAAC,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,8BAA8B,EAAE,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAE/F,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"}
+{"version":3,"file":"document-links.js","sourceRoot":"","sources":["../src/document-links.ts"],"names":[],"mappings":"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"}

package/dist/hover.d.ts

@@ -3,6 +3,7 @@ import { FileProvider } from "@actions/workflow-parser/workflows/file-provider";
 import { Position, TextDocument } from "vscode-languageserver-textdocument";
 import { Hover } from "vscode-languageserver-types";
 import { ContextProviderConfig } from "./context-providers/config.js";
+import { ActionContext } from "./context/action-context.js";
 import { WorkflowContext } from "./context/workflow-context.js";
 export type HoverConfig = {
     descriptionProvider?: DescriptionProvider;
@@ -10,7 +11,10 @@ export type HoverConfig = {
     fileProvider?: FileProvider;
 };
 export type DescriptionProvider = {
-    getDescription(context: WorkflowContext, token: TemplateToken, path: TemplateToken[]): Promise<string | undefined>;
+    getDescription(context: WorkflowContext | ActionContext, token: TemplateToken, path: TemplateToken[]): Promise<string | undefined>;
 };
+/**
+ * Returns hover information for the token at the given position.
+ */
 export declare function hover(document: TextDocument, position: Position, config?: HoverConfig): Promise<Hover | null>;
 //# sourceMappingURL=hover.d.ts.map

package/dist/hover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../src/hover.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,aAAa,EAAC,MAAM,0DAA0D,CAAC;AAGvF,OAAO,EAAC,YAAY,EAAC,MAAM,kDAAkD,CAAC;AAC9E,OAAO,EAAC,QAAQ,EAAE,YAAY,EAAC,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAC,KAAK,EAAC,MAAM,6BAA6B,CAAC;AAClD,OAAO,EAAC,qBAAqB,EAAC,MAAM,+BAA+B,CAAC;AAGpE,OAAO,EAAqB,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAalF,MAAM,MAAM,WAAW,GAAG;IACxB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACpH,CAAC;AAEF,wBAAsB,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAoEnH"}
+{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../src/hover.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,aAAa,EAAC,MAAM,0DAA0D,CAAC;AAGvF,OAAO,EAAC,YAAY,EAAC,MAAM,kDAAkD,CAAC;AAC9E,OAAO,EAAC,QAAQ,EAAE,YAAY,EAAC,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAC,KAAK,EAAC,MAAM,6BAA6B,CAAC;AAClD,OAAO,EAAC,qBAAqB,EAAC,MAAM,+BAA+B,CAAC;AAGpE,OAAO,EAAC,aAAa,EAAmB,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAqB,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAelF,MAAM,MAAM,WAAW,GAAG;IACxB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,CACZ,OAAO,EAAE,eAAe,GAAG,aAAa,EACxC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,aAAa,EAAE,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAuGnH"}

package/dist/hover.js

@@ -1,70 +1,102 @@
 import { data, Parser } from "@actions/expressions";
 import { Lexer } from "@actions/expressions/lexer";
+import { parseAction } from "@actions/workflow-parser/actions/action-parser";
 import { ErrorPolicy } from "@actions/workflow-parser/model/convert";
 import { splitAllowedContext } from "@actions/workflow-parser/templates/allowed-context";
 import { isBasicExpression } from "@actions/workflow-parser/templates/tokens/type-guards";
-import { getContext, Mode } from "./context-providers/default.js";
+import { getActionExpressionContext, getWorkflowExpressionContext, Mode } from "./context-providers/default.js";
 import { getFunctionDescription } from "./context-providers/descriptions.js";
+import { getActionContext } from "./context/action-context.js";
 import { getWorkflowContext } from "./context/workflow-context.js";
 import { getReusableWorkflowInputDescription, isReusableWorkflowJobInput } from "./description-providers/reusable-job-inputs.js";
 import { mapToExpressionPos } from "./expression-hover/expression-pos.js";
 import { HoverVisitor } from "./expression-hover/visitor.js";
 import { info } from "./log.js";
+import { nullTrace } from "./nulltrace.js";
+import { isActionDocument } from "./utils/document-type.js";
 import { isPotentiallyExpression } from "./utils/expression-detection.js";
 import { findToken } from "./utils/find-token.js";
 import { mapRange } from "./utils/range.js";
-import { fetchOrConvertWorkflowTemplate, fetchOrParseWorkflow } from "./utils/workflow-cache.js";
+import { getOrConvertActionTemplate, getOrConvertWorkflowTemplate, getOrParseWorkflow } from "./utils/workflow-cache.js";
+/**
+ * Returns hover information for the token at the given position.
+ */
 export async function hover(document, position, config) {
     const file = {
         name: document.uri,
         content: document.getText()
     };
-    const parsedWorkflow = fetchOrParseWorkflow(file, document.uri);
-    if (!parsedWorkflow?.value) {
+    // Determine document type based on file path (action.yml vs workflow file)
+    const isAction = isActionDocument(document.uri);
+    // Parse document
+    const parsedTemplate = isAction ? parseAction(file, nullTrace) : getOrParseWorkflow(file, document.uri);
+    if (!parsedTemplate?.value) {
         return null;
     }
-    const template = await fetchOrConvertWorkflowTemplate(parsedWorkflow.context, parsedWorkflow.value, document.uri, config, {
-        errorPolicy: ErrorPolicy.TryConversion,
-        fetchReusableWorkflowDepth: config?.fileProvider ? 1 : 0
-    });
-    const tokenResult = findToken(position, parsedWorkflow.value);
+    // Find the token at the cursor position
+    const tokenResult = findToken(position, parsedTemplate.value);
     const { token, keyToken, parent } = tokenResult;
     const tokenDefinitionInfo = (keyToken || parent || token)?.definitionInfo;
-    const workflowContext = getWorkflowContext(document.uri, template, tokenResult.path);
-    if (token && tokenDefinitionInfo) {
-        if (isBasicExpression(token) || isPotentiallyExpression(token)) {
-            info(`Calculating expression hover for token with definition ${tokenDefinitionInfo.definition.key}`);
-            const allowedContext = tokenDefinitionInfo.allowedContext || [];
-            const { namedContexts, functions } = splitAllowedContext(allowedContext);
-            const context = await getContext(namedContexts, config?.contextProviderConfig, workflowContext, Mode.Completion);
-            for (const func of functions) {
-                func.description = getFunctionDescription(func.name);
-            }
-            const exprPos = mapToExpressionPos(token, position);
-            if (exprPos) {
-                return expressionHover(exprPos, context, namedContexts, functions);
-            }
+    // Early exit if there's nothing to provide hover for
+    const hoverToken = token || keyToken;
+    const isExpressionHover = token && tokenDefinitionInfo && (isBasicExpression(token) || isPotentiallyExpression(token));
+    if (!isExpressionHover && !hoverToken?.definition) {
+        return null;
+    }
+    // Build document context (jobs, steps, inputs, etc.) from the parsed template
+    const documentContext = isAction
+        ? getActionContext(document.uri, getOrConvertActionTemplate(parsedTemplate.context, parsedTemplate.value, document.uri, {
+            errorPolicy: ErrorPolicy.TryConversion
+        }), tokenResult.path)
+        : getWorkflowContext(document.uri, await getOrConvertWorkflowTemplate(parsedTemplate.context, parsedTemplate.value, document.uri, config, {
+            errorPolicy: ErrorPolicy.TryConversion,
+            fetchReusableWorkflowDepth: config?.fileProvider ? 1 : 0
+        }), tokenResult.path);
+    // Expression hover
+    if (isExpressionHover) {
+        info(`Calculating expression hover for token with definition ${tokenDefinitionInfo.definition.key}`);
+        const allowedContext = tokenDefinitionInfo.allowedContext || [];
+        const { namedContexts, functions } = splitAllowedContext(allowedContext);
+        // Build expression context with named contexts (github, env, etc.) and their descriptions
+        const expressionContext = isAction
+            ? getActionExpressionContext(namedContexts, config?.contextProviderConfig, documentContext, Mode.Hover)
+            : await getWorkflowExpressionContext(namedContexts, config?.contextProviderConfig, documentContext, Mode.Hover);
+        // Populate function descriptions for hover display
+        for (const func of functions) {
+            func.description = getFunctionDescription(func.name);
+        }
+        // Convert document position to expression-relative position
+        const exprPos = mapToExpressionPos(token, position);
+        if (exprPos) {
+            // Find the expression element at the cursor and return its description
+            return expressionHover(exprPos, expressionContext, namedContexts, functions);
         }
     }
-    if (!token?.definition) {
+    if (!hoverToken?.definition) {
         return null;
     }
-    info(`Calculating hover for token with definition ${token.definition.key}`);
-    if (tokenResult.parent && isReusableWorkflowJobInput(tokenResult)) {
-        let description = getReusableWorkflowInputDescription(workflowContext, tokenResult);
-        description = appendContext(description, token.definitionInfo?.allowedContext);
-        return {
-            contents: description,
-            range: mapRange(token.range)
-        };
+    // Non-expression hover: show the schema description for the YAML key or value
+    info(`Calculating hover for token with definition ${hoverToken.definition.key}`);
+    let description;
+    if (!isAction && tokenResult.parent && isReusableWorkflowJobInput(tokenResult)) {
+        // Reusable workflow call: fetch the called workflow's input descriptions
+        description = getReusableWorkflowInputDescription(documentContext, tokenResult);
+    }
+    else {
+        // Default: use custom provider or token's schema description
+        description =
+            (await getDescription(config, documentContext, hoverToken, tokenResult.path)) || hoverToken.description || "";
     }
-    let description = await getDescription(config, workflowContext, token, tokenResult.path);
-    description = appendContext(description, token.definitionInfo?.allowedContext);
+    // Return hover with description and available expression contexts
     return {
-        contents: description,
-        range: mapRange(token.range)
+        contents: appendContext(description, hoverToken.definitionInfo?.allowedContext),
+        range: mapRange(hoverToken.range)
     };
 }
+/**
+ * Appends available expression contexts and functions to a hover description.
+ * For example: "Available expression contexts: `github`, `env`"
+ */
 function appendContext(description, allowedContext) {
     if (!allowedContext || allowedContext.length == 0) {
         return description;
@@ -85,15 +117,21 @@ function appendContext(description, allowedContext) {
     }
     return `${description}${namedContextsString}${functionsString}`;
 }
-async function getDescription(config, workflowContext, token, path) {
-    const defaultDescription = token.description || "";
+/**
+ * Gets a custom description from the configured description provider.
+ * Used to fetch rich descriptions like action input docs from GitHub repos.
+ */
+async function getDescription(config, documentContext, token, path) {
     if (!config?.descriptionProvider) {
-        return defaultDescription;
+        return undefined;
     }
-    const description = await config.descriptionProvider.getDescription(workflowContext, token, path);
-    return description || defaultDescription;
+    return await config.descriptionProvider.getDescription(documentContext, token, path);
 }
-function expressionHover(exprPos, context, namedContexts, functions) {
+/**
+ * Parses an expression and finds the element at the cursor position to show its description.
+ * For example, hovering over `github.actor` shows "The login of the user that triggered the workflow".
+ */
+function expressionHover(exprPos, expressionContext, namedContexts, functions) {
     const { expression, position, documentRange } = exprPos;
     try {
         const l = new Lexer(expression);
@@ -107,7 +145,7 @@ function expressionHover(exprPos, context, namedContexts, functions) {
                 call: () => new data.Null()
             });
         }
-        const hv = new HoverVisitor(position, context, functionMap);
+        const hv = new HoverVisitor(position, expressionContext, functionMap);
         const hoverResult = hv.hover(expr);
         if (!hoverResult) {
             return null;

package/dist/hover.js.map

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

package/dist/inlay-hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inlay-hints.d.ts","sourceRoot":"","sources":["../src/inlay-hints.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAC,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAC,SAAS,EAAgB,MAAM,6BAA6B,CAAC;AAGrE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,CAuCjE"}
+{"version":3,"file":"inlay-hints.d.ts","sourceRoot":"","sources":["../src/inlay-hints.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAC,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAC,SAAS,EAAgB,MAAM,6BAA6B,CAAC;AAIrE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,CA4CjE"}

package/dist/inlay-hints.js

@@ -2,7 +2,8 @@ import { isString } from "@actions/workflow-parser";
 import { getCronDescription } from "@actions/workflow-parser/model/converter/cron";
 import { TemplateToken } from "@actions/workflow-parser/templates/tokens/template-token";
 import { InlayHintKind } from "vscode-languageserver-types";
-import { fetchOrParseWorkflow } from "./utils/workflow-cache.js";
+import { isActionDocument } from "./utils/document-type.js";
+import { getOrParseWorkflow } from "./utils/workflow-cache.js";
 /**
  * Returns inlay hints for a workflow document.
  * Currently supports cron expressions, showing a human-readable description
@@ -12,11 +13,15 @@ import { fetchOrParseWorkflow } from "./utils/workflow-cache.js";
  * @returns Array of inlay hints
  */
 export function getInlayHints(document) {
+    // Inlay hints are only supported for workflow files (cron expressions)
+    if (isActionDocument(document.uri)) {
+        return [];
+    }
     const file = {
         name: document.uri,
         content: document.getText()
     };
-    const result = fetchOrParseWorkflow(file, document.uri);
+    const result = getOrParseWorkflow(file, document.uri);
     if (!result?.value) {
         return [];
     }

package/dist/inlay-hints.js.map

@@ -1 +1 @@
-{"version":3,"file":"inlay-hints.js","sourceRoot":"","sources":["../src/inlay-hints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAC,kBAAkB,EAAC,MAAM,+CAA+C,CAAC;AACjF,OAAO,EAAC,aAAa,EAAC,MAAM,0DAA0D,CAAC;AAGvF,OAAO,EAAY,aAAa,EAAC,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,QAAQ,CAAC,GAAG;QAClB,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;KAC5B,CAAC;IAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE;QAClB,OAAO,EAAE,CAAC;KACX;IAED,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,qDAAqD;IACrD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QACvE,MAAM,eAAe,GAAG,GAAG,IAAI,MAAM,IAAI,KAAK,CAAC;QAC/C,MAAM,oBAAoB,GAAG,eAAe,CAAC,UAAU,CAAC;QAExD,gCAAgC;QAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,IAAI,oBAAoB,EAAE,GAAG,KAAK,cAAc,EAAE;YAClF,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC;YAC9B,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAElD,IAAI,WAAW,EAAE;gBACf,iDAAiD;gBACjD,KAAK,CAAC,IAAI,CAAC;oBACT,QAAQ,EAAE;wBACR,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;wBAC9B,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,kCAAkC;qBACzE;oBACD,KAAK,EAAE,KAAK,WAAW,EAAE;oBACzB,IAAI,EAAE,aAAa,CAAC,SAAS;oBAC7B,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;aACJ;SACF;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"inlay-hints.js","sourceRoot":"","sources":["../src/inlay-hints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAC,kBAAkB,EAAC,MAAM,+CAA+C,CAAC;AACjF,OAAO,EAAC,aAAa,EAAC,MAAM,0DAA0D,CAAC;AAGvF,OAAO,EAAY,aAAa,EAAC,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAC,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,2BAA2B,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,uEAAuE;IACvE,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QAClC,OAAO,EAAE,CAAC;KACX;IAED,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,QAAQ,CAAC,GAAG;QAClB,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;KAC5B,CAAC;IAEF,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE;QAClB,OAAO,EAAE,CAAC;KACX;IAED,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,qDAAqD;IACrD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QACvE,MAAM,eAAe,GAAG,GAAG,IAAI,MAAM,IAAI,KAAK,CAAC;QAC/C,MAAM,oBAAoB,GAAG,eAAe,CAAC,UAAU,CAAC;QAExD,gCAAgC;QAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,IAAI,oBAAoB,EAAE,GAAG,KAAK,cAAc,EAAE;YAClF,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC;YAC9B,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAElD,IAAI,WAAW,EAAE;gBACf,iDAAiD;gBACjD,KAAK,CAAC,IAAI,CAAC;oBACT,QAAQ,EAAE;wBACR,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;wBAC9B,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,kCAAkC;qBACzE;oBACD,KAAK,EAAE,KAAK,WAAW,EAAE;oBACzB,IAAI,EAAE,aAAa,CAAC,SAAS;oBAC7B,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;aACJ;SACF;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/document-type.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Document type detection for workflow and action files.
+ * Detection is based on file path/name only - content heuristics are not used
+ * because files in non-standard locations wouldn't work as workflows/actions anyway.
+ */
+export type DocumentType = "workflow" | "action" | "unknown";
+/**
+ * Detects whether a document is a workflow file, action file, or unknown based on its URI.
+ *
+ * @param uri The document URI or file path
+ * @returns The detected document type
+ */
+export declare function detectDocumentType(uri: string): DocumentType;
+/**
+ * Check if a document is an action file
+ */
+export declare function isActionDocument(uri: string): boolean;
+/**
+ * Check if a document is a workflow file
+ */
+export declare function isWorkflowDocument(uri: string): boolean;
+//# sourceMappingURL=document-type.d.ts.map

package/dist/utils/document-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-type.d.ts","sourceRoot":"","sources":["../../src/utils/document-type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAmB5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/utils/document-type.js

@@ -0,0 +1,41 @@
+/**
+ * Document type detection for workflow and action files.
+ * Detection is based on file path/name only - content heuristics are not used
+ * because files in non-standard locations wouldn't work as workflows/actions anyway.
+ */
+/**
+ * Detects whether a document is a workflow file, action file, or unknown based on its URI.
+ *
+ * @param uri The document URI or file path
+ * @returns The detected document type
+ */
+export function detectDocumentType(uri) {
+    // Normalize path separators
+    const normalizedUri = uri.replace(/\\/g, "/");
+    // Check for workflow file patterns FIRST (more specific path takes precedence)
+    // Matches: .github/workflows/*.yml or .github/workflows/*.yaml
+    // Also matches: .github/workflows-lab/*.yml or .github/workflows-lab/*.yaml
+    // This ensures .github/workflows/action.yml is treated as a workflow, not an action
+    if (/\.github\/workflows(-lab)?\/[^/]+\.ya?ml$/i.test(normalizedUri)) {
+        return "workflow";
+    }
+    // Check for action.yml/action.yaml patterns
+    // Matches: action.yml, action.yaml, .github/actions/my-action/action.yml, etc.
+    if (/\/action\.ya?ml$/i.test(normalizedUri) || /^action\.ya?ml$/i.test(normalizedUri)) {
+        return "action";
+    }
+    return "unknown";
+}
+/**
+ * Check if a document is an action file
+ */
+export function isActionDocument(uri) {
+    return detectDocumentType(uri) === "action";
+}
+/**
+ * Check if a document is a workflow file
+ */
+export function isWorkflowDocument(uri) {
+    return detectDocumentType(uri) === "workflow";
+}
+//# sourceMappingURL=document-type.js.map

package/dist/utils/document-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-type.js","sourceRoot":"","sources":["../../src/utils/document-type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,4BAA4B;IAC5B,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE9C,+EAA+E;IAC/E,+DAA+D;IAC/D,4EAA4E;IAC5E,oFAAoF;IACpF,IAAI,4CAA4C,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE;QACpE,OAAO,UAAU,CAAC;KACnB;IAED,4CAA4C;IAC5C,+EAA+E;IAC/E,IAAI,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE;QACrF,OAAO,QAAQ,CAAC;KACjB;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,kBAAkB,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,kBAAkB,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC;AAChD,CAAC"}

package/dist/utils/transform.d.ts

@@ -1,6 +1,24 @@
 import { StringToken } from "@actions/workflow-parser/templates/tokens/string-token";
 import { TemplateToken } from "@actions/workflow-parser/templates/tokens/template-token";
 import { Position, TextDocument } from "vscode-languageserver-textdocument";
+/**
+ * Transforms a document to make it valid YAML so the parser can understand
+ * the cursor position during auto-completion.
+ *
+ * When typing in an IDE, the document is usually invalid YAML:
+ * - `runs-on` without `:` isn't a valid key
+ * - Empty lines don't parse as anything
+ * - `- ` without a value isn't complete
+ *
+ * This function inserts placeholders to make the document parseable:
+ * - Empty line → inserts `key:` placeholder
+ * - Line without colon → appends `:`
+ * - Sequence item `- ` → inserts `key` after the dash
+ *
+ * Lines containing `${{` are skipped to avoid breaking multi-line strings.
+ *
+ * The `isPlaceholder()` helper filters out the fake entries from completions.
+ */
 export declare function transform(doc: TextDocument, pos: Position): [TextDocument, Position];
 export declare function isPlaceholder(key: StringToken, value: TemplateToken): boolean;
 //# sourceMappingURL=transform.d.ts.map

package/dist/utils/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/utils/transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAC,MAAM,wDAAwD,CAAC;AACnF,OAAO,EAAC,aAAa,EAAC,MAAM,0DAA0D,CAAC;AACvF,OAAO,EAAC,QAAQ,EAAE,YAAY,EAAC,MAAM,oCAAoC,CAAC;AAO1E,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAkEpF;AAGD,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,WAMnE"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/utils/transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAC,MAAM,wDAAwD,CAAC;AACnF,OAAO,EAAC,aAAa,EAAC,MAAM,0DAA0D,CAAC;AACvF,OAAO,EAAC,QAAQ,EAAE,YAAY,EAAC,MAAM,oCAAoC,CAAC;AAK1E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAkEpF;AAGD,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,WAMnE"}

package/dist/utils/transform.js

@@ -1,8 +1,24 @@
 import { isString } from "@actions/workflow-parser";
 import { TextDocument } from "vscode-languageserver-textdocument";
 const PLACEHOLDER_KEY = "key";
-// Transform a document to work around YAML parsing issues
-// Based on `_transform` in https://github.com/cschleiden/github-actions-parser/blob/main/src/lib/parser/complete.ts#L311
+/**
+ * Transforms a document to make it valid YAML so the parser can understand
+ * the cursor position during auto-completion.
+ *
+ * When typing in an IDE, the document is usually invalid YAML:
+ * - `runs-on` without `:` isn't a valid key
+ * - Empty lines don't parse as anything
+ * - `- ` without a value isn't complete
+ *
+ * This function inserts placeholders to make the document parseable:
+ * - Empty line → inserts `key:` placeholder
+ * - Line without colon → appends `:`
+ * - Sequence item `- ` → inserts `key` after the dash
+ *
+ * Lines containing `${{` are skipped to avoid breaking multi-line strings.
+ *
+ * The `isPlaceholder()` helper filters out the fake entries from completions.
+ */
 export function transform(doc, pos) {
     let offset = doc.offsetAt(pos);
     const lineRange = {

package/dist/utils/transform.js.map

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

package/dist/utils/workflow-cache.d.ts

@@ -1,4 +1,5 @@
-import { ParseWorkflowResult, WorkflowTemplate } from "@actions/workflow-parser";
+import { TemplateParseResult, WorkflowTemplate } from "@actions/workflow-parser";
+import { ActionTemplate, ActionTemplateConverterOptions } from "@actions/workflow-parser/actions/action-template";
 import { WorkflowTemplateConverterOptions } from "@actions/workflow-parser/model/convert";
 import { TemplateContext } from "@actions/workflow-parser/templates/template-context";
 import { TemplateToken } from "@actions/workflow-parser/templates/tokens/template-token";
@@ -7,15 +8,27 @@ import { CompletionConfig } from "../complete.js";
 export declare function clearCacheEntry(uri: string): void;
 export declare function clearCache(): void;
 /**
- * Parses a workflow file and caches the result
+ * Parses a workflow file, returning cached result if available
  * @param transformed Indicates whether the workflow has been transformed before parsing
- * @returns the {@link ParseWorkflowResult}
+ * @returns the {@link TemplateParseResult}
  */
-export declare function fetchOrParseWorkflow(file: File, uri: string, transformed?: boolean): ParseWorkflowResult;
+export declare function getOrParseWorkflow(file: File, uri: string, transformed?: boolean): TemplateParseResult;
 /**
- * Converts a workflow template and caches the result
+ * Parses an action file, returning cached result if available
+ * @param transformed Indicates whether the action has been transformed before parsing
+ * @returns the {@link TemplateParseResult}
+ */
+export declare function getOrParseAction(file: File, uri: string, transformed?: boolean): TemplateParseResult;
+/**
+ * Converts a workflow template, returning cached result if available
  * @param transformed Indicates whether the workflow has been transformed before parsing
  * @returns the converted {@link WorkflowTemplate}
  */
-export declare function fetchOrConvertWorkflowTemplate(context: TemplateContext, template: TemplateToken, uri: string, config?: CompletionConfig, options?: WorkflowTemplateConverterOptions, transformed?: boolean): Promise<WorkflowTemplate>;
+export declare function getOrConvertWorkflowTemplate(context: TemplateContext, template: TemplateToken, uri: string, config?: CompletionConfig, options?: WorkflowTemplateConverterOptions, transformed?: boolean): Promise<WorkflowTemplate>;
+/**
+ * Converts an action template, returning cached result if available
+ * @param transformed Indicates whether the action has been transformed before parsing
+ * @returns the converted {@link ActionTemplate}
+ */
+export declare function getOrConvertActionTemplate(context: TemplateContext, template: TemplateToken, uri: string, options?: ActionTemplateConverterOptions, transformed?: boolean): ActionTemplate;
 //# sourceMappingURL=workflow-cache.d.ts.map

package/dist/utils/workflow-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-cache.d.ts","sourceRoot":"","sources":["../../src/utils/workflow-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,mBAAmB,EAAE,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AACvH,OAAO,EAAC,gCAAgC,EAAC,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAC,eAAe,EAAC,MAAM,qDAAqD,CAAC;AACpF,OAAO,EAAC,aAAa,EAAC,MAAM,0DAA0D,CAAC;AACvF,OAAO,EAAC,IAAI,EAAC,MAAM,yCAAyC,CAAC;AAE7D,OAAO,EAAC,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAMhD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,QAK1C;AAED,wBAAgB,UAAU,SAGzB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,mBAAmB,CAStG;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,gCAAgC,EAC1C,WAAW,UAAQ,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAS3B"}
+{"version":3,"file":"workflow-cache.d.ts","sourceRoot":"","sources":["../../src/utils/workflow-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,mBAAmB,EAAE,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAEvH,OAAO,EACL,cAAc,EACd,8BAA8B,EAE/B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAC,gCAAgC,EAAC,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAC,eAAe,EAAC,MAAM,qDAAqD,CAAC;AACpF,OAAO,EAAC,aAAa,EAAC,MAAM,0DAA0D,CAAC;AACvF,OAAO,EAAC,IAAI,EAAC,MAAM,yCAAyC,CAAC;AAE7D,OAAO,EAAC,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAQhD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,QAS1C;AAED,wBAAgB,UAAU,SAKzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,mBAAmB,CASpG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,mBAAmB,CASlG;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,gCAAgC,EAC1C,WAAW,UAAQ,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,8BAA8B,EACxC,WAAW,UAAQ,GAClB,cAAc,CAShB"}