🚀 [Feature]: Module manifests now stamped with the resolved version at build time

[Marius Storhaug (MariusStorhaug)]

Module manifests can now be stamped with a resolved version and prerelease tag at build time. The resulting artifact contains its final ModuleVersion (and PrivateData.PSData.Prerelease) before tests run, so the bytes that are tested are the bytes that ship.

• Fixes Move version calculation to a Plan job (Resolve-PSModuleVersion) so Build and Publish never calculate or mutate versions Process-PSModule#326

New: Version and Prerelease inputs on Build-PSModule

Build-PSModule now accepts two optional inputs:

Input	Description
Version	Module version (Major.Minor.Patch) to stamp into the manifest. When empty, the manifest keeps the legacy 999.0.0 default.
Prerelease	Prerelease tag (for example mybranch001) to stamp into PrivateData.PSData.Prerelease. When empty, no prerelease tag is written.

Typical usage downstream of PSModule/Resolve-PSModuleVersion:

- name: Build module
  uses: PSModule/Build-PSModule@v5
  with:
    Name: MyModule
    Version: ${{ steps.resolve.outputs.Version }}
    Prerelease: ${{ steps.resolve.outputs.Prerelease }}

Changed: Manifest version source of truth

The hard-coded '999.0.0' placeholder is now used only when no Version input is supplied (for example when Build-PSModule is run outside the standard Plan → Build → Test → Publish flow). When Version is supplied, that value is written directly to ModuleVersion.

Existing workflows that do not pass Version continue to behave exactly as before.

Technical Details

• action.yml: adds Version and Prerelease inputs mapped to PSMODULE_BUILD_PSMODULE_INPUT_Version and PSMODULE_BUILD_PSMODULE_INPUT_Prerelease.
• src/main.ps1: reads the new env vars and forwards them to Build-PSModule as ModuleVersion and ModulePrerelease.
• src/helpers/Build-PSModule.ps1: adds [string] $ModuleVersion and [string] $ModulePrerelease parameters, forwards both to Build-PSModuleManifest.
• src/helpers/Build/Build-PSModuleManifest.ps1:
  • $manifest.ModuleVersion is now if ([string]::IsNullOrWhiteSpace($ModuleVersion)) { '999.0.0' } else { $ModuleVersion }.
  • The previously commented-out # $manifest.PreRelease = "" # Is managed by the publish action block now sets $manifest.Prerelease = $ModulePrerelease when the input is provided. New-ModuleManifest routes this into PrivateData.PSData.Prerelease.

Related PRs:

• 🌟 [Major]: Module version resolution now available as a standalone action Resolve-PSModuleVersion#1 — emits the Version and Prerelease values consumed here.
• 💥 [Major]: Drop version calculation, publish pre-stamped artifact, upload module zip to release (PSModule/Process-PSModule#326) Publish-PSModule#71 — drops its own version stamping; expects the artifact to arrive pre-stamped.
• 🚀 [Minor]: Plan job decides version before build so tested artifact equals published artifact (#326) Process-PSModule#342 — wires the workflow end-to-end.