Add version-file input to read the Helm version from a .tool-versions file

[somaz94]

Closes #272.

Adds a version-file input that reads the Helm version from a .tool-versions file (the format used by asdf and mise), mirroring the *-version-file inputs in actions/setup-go and actions/setup-node.

Behavior

• version-file points to a .tool-versions file; the action reads the version declared for the helm tool (e.g. helm 3.18.4).
• The parsed version flows through the existing normalization, so an unprefixed 3.18.4 resolves to v3.18.4, and latest is honored.
• If both version and version-file are set, version takes precedence (a warning is emitted), matching actions/setup-go.
• Clear errors when the file is missing or declares no helm version.
• The version input is relaxed to required: false (default latest unchanged).

Validation

• npm run typecheck — passes
• npm test (vitest) — 26/26 pass, including 7 new tests covering the parser, the file reader, precedence, and error paths
• npm run format-check — clean

lib/ is gitignored and built by the release workflow, so no bundle is committed here.

[somaz94]

@microsoft-github-policy-service agree

[Copilot]

Pull request overview

Adds support for resolving the Helm version from a .tool-versions file via a new version-file action input, integrating it into the existing version normalization flow used by azure/setup-helm.

Changes:

• Add version-file input and implement .tool-versions parsing + file reading to resolve helm version.
• Relax version input to required: false while keeping latest as the default.
• Document version-file usage in the README and add unit tests for the parser/file reader helpers.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File	Description
src/run.ts	Adds version-file resolution in run(), plus .tool-versions parsing and file-reading helpers.
src/run.test.ts	Extends mocks and adds unit tests for parsing and reading .tool-versions.
README.md	Documents the new version-file input and expected .tool-versions format.
action.yml	Adds the version-file input and makes version non-required (default remains latest).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[bosesuneha]

lgtm

[Tatsinnit]

❤️ Thank you so much for this contribution, The lenient regex is fine because:

• It's checking for "semver-shaped" strings, not strict validation
• It correctly rejects clearly wrong values like latest or 3.14
• Edge cases like 3.14.0--- would likely fail when actually trying to download that Helm version anyway

So it's good for the intended purpose of distinguishing version numbers from keywords, even if not perfectly spec-compliant. (but that's just a note for other folks to see like @davidgamero or @bosesuneha - who are regular for this repo releases.)