🚀 [Feature]: Add ReleaseType input for explicit release control (#59)

The action now supports explicit control over the release type through
the new `ReleaseType` input parameter. You can specify whether to create
a stable release, prerelease, or skip releasing entirely—without relying
on automatic detection from PR state and labels. The workflow has also
been restructured into three phases (initialization, publishing,
cleanup) that run conditionally, improving efficiency when only cleanup
is needed.

- Part of PSModule/Process-PSModule#73
- Part of PSModule/Process-PSModule#265

## New ReleaseType input parameter

A new `ReleaseType` input allows you to explicitly control the release
behavior:

| Value | Description |
|-------|-------------|
| `Release` | Create a stable release (default) |
| `Prerelease` | Create a prerelease |
| `None` | Do not create any release |

This input is designed to work with `Get-PSModuleSettings`, which
pre-calculates the appropriate release type based on your workflow
context:

```yaml
- uses: PSModule/Publish-PSModule@v2
  with:
    APIKey: ${{ secrets.PSGALLERY_API_KEY }}
    ReleaseType: ${{ fromJson(inputs.Settings).Publish.Module.ReleaseType }}
    AutoCleanup: ${{ fromJson(inputs.Settings).Publish.Module.AutoCleanup }}
```

## Restructured workflow execution

The action now runs in three separate phases, each executing only when
needed:

1. **Initialize Publish Context** (`init.ps1`) – Calculates version,
validates inputs, and stores context in environment variables
2. **Publish Module** (`publish.ps1`) – Downloads artifact, updates
manifest, publishes to PSGallery, and creates GitHub release (runs only
when `ShouldPublish` is true)
3. **Cleanup Prereleases** (`cleanup.ps1`) – Deletes old prerelease tags
(runs only when `ShouldCleanup` is true)

This separation means the action skips unnecessary steps. For example,
when a PR is closed without merging, the workflow can run cleanup
independently without downloading artifacts or attempting to publish.

## Backward compatibility

The `ReleaseType` parameter defaults to `Release`, maintaining current
behavior for merged PRs targeting the default branch. Existing workflows
continue to work without modification.

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: MariusStorhaug

.github/workflows/Action-Test.yml

@@ -26,6 +26,12 @@ jobs:
         with:
           persist-credentials: false
 
+      - name: Upload module artifact
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
+        with:
+          name: module
+          path: tests/outputs/module
+
       - name: Action-Test
         uses: ./
         env:

action.yml

@@ -14,11 +14,11 @@ inputs:
     description: PowerShell Gallery API Key.
     required: true
   AutoCleanup:
-    description: Control wether to automatically delete the prerelease tags after the stable release is created.
+    description: Control whether to automatically delete the prerelease tags after the stable release is created.
     required: false
     default: 'true'
   AutoPatching:
-    description: Control wether to automatically handle patches. If disabled, the action will only create a patch release if the pull request has a 'patch' label.
+    description: Control whether to automatically handle patches. If disabled, the action will only create a patch release if the pull request has a 'patch' label.
     required: false
     default: 'true'
   IncrementalPrerelease:
@@ -49,6 +49,10 @@ inputs:
     description: A comma separated list of labels that do not trigger a release.
     required: false
     default: NoRelease
+  ReleaseType:
+    description: The type of release to create. Values are 'Release' (stable), 'Prerelease', or 'None'.
+    required: false
+    default: Release
   WhatIf:
     description: If specified, the action will only log the changes it would make, but will not actually create or delete any releases or tags.
     required: false
@@ -76,24 +80,55 @@ runs:
     - name: Install-PSModuleHelpers
       uses: PSModule/Install-PSModuleHelpers@d60d63e4be477d1ca0c67c6085101fb109bce8f1 # v1.0.6
 
-    - name: Run Publish-PSModule
+    - name: Update Microsoft.PowerShell.PSResourceGet
+      shell: pwsh
+      run: |
+        Install-PSResource -Name Microsoft.PowerShell.PSResourceGet -Repository PSGallery -TrustRepository
+
+    - name: Initialize Publish Context
+      id: init
       shell: pwsh
       working-directory: ${{ inputs.WorkingDirectory }}
       env:
         PSMODULE_PUBLISH_PSMODULE_INPUT_Name: ${{ inputs.Name }}
-        PSMODULE_PUBLISH_PSMODULE_INPUT_ModulePath: ${{ inputs.ModulePath }}
-        PSMODULE_PUBLISH_PSMODULE_INPUT_APIKey: ${{ inputs.APIKey }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_AutoCleanup: ${{ inputs.AutoCleanup }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_AutoPatching: ${{ inputs.AutoPatching }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_DatePrereleaseFormat: ${{ inputs.DatePrereleaseFormat }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_IgnoreLabels: ${{ inputs.IgnoreLabels }}
+        PSMODULE_PUBLISH_PSMODULE_INPUT_ReleaseType: ${{ inputs.ReleaseType }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_IncrementalPrerelease: ${{ inputs.IncrementalPrerelease }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_MajorLabels: ${{ inputs.MajorLabels }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_MinorLabels: ${{ inputs.MinorLabels }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_PatchLabels: ${{ inputs.PatchLabels }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_VersionPrefix: ${{ inputs.VersionPrefix }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_WhatIf: ${{ inputs.WhatIf }}
+      run: ${{ github.action_path }}/scripts/init.ps1
+
+    - name: Download module artifact
+      if: env.PUBLISH_CONTEXT_ShouldPublish == 'true' || inputs.WhatIf == 'true'
+      uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
+      with:
+        name: module
+        path: ${{ inputs.ModulePath }}
+
+    - name: Publish Module
+      if: env.PUBLISH_CONTEXT_ShouldPublish == 'true' || inputs.WhatIf == 'true'
+      shell: pwsh
+      working-directory: ${{ inputs.WorkingDirectory }}
+      env:
+        PSMODULE_PUBLISH_PSMODULE_INPUT_Name: ${{ inputs.Name }}
+        PSMODULE_PUBLISH_PSMODULE_INPUT_ModulePath: ${{ inputs.ModulePath }}
+        PSMODULE_PUBLISH_PSMODULE_INPUT_APIKey: ${{ inputs.APIKey }}
+        PSMODULE_PUBLISH_PSMODULE_INPUT_WhatIf: ${{ inputs.WhatIf }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRBodyAsReleaseNotes: ${{ inputs.UsePRBodyAsReleaseNotes }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsReleaseName: ${{ inputs.UsePRTitleAsReleaseName }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsNotesHeading: ${{ inputs.UsePRTitleAsNotesHeading }}
-      run: ${{ github.action_path }}/scripts/main.ps1
+      run: ${{ github.action_path }}/scripts/publish.ps1
+
+    - name: Cleanup Prereleases
+      if: env.PUBLISH_CONTEXT_ShouldCleanup == 'true' || inputs.WhatIf == 'true'
+      shell: pwsh
+      working-directory: ${{ inputs.WorkingDirectory }}
+      env:
+        PSMODULE_PUBLISH_PSMODULE_INPUT_WhatIf: ${{ inputs.WhatIf }}
+      run: ${{ github.action_path }}/scripts/cleanup.ps1

scripts/cleanup.ps1

@@ -0,0 +1,47 @@
+[CmdletBinding()]
+param()
+
+Import-Module -Name 'Helpers' -Force
+
+$prereleaseName = $env:PUBLISH_CONTEXT_PrereleaseName
+$prereleaseTagsToCleanup = $env:PUBLISH_CONTEXT_PrereleaseTagsToCleanup
+$whatIf = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_WhatIf -eq 'true'
+
+if ([string]::IsNullOrWhiteSpace($prereleaseName)) {
+    Write-Error 'PUBLISH_CONTEXT_PrereleaseName is not set. Run init.ps1 first.'
+    exit 1
+}
+
+LogGroup "Cleanup prereleases for [$prereleaseName]" {
+    if ([string]::IsNullOrWhiteSpace($prereleaseTagsToCleanup)) {
+        Write-Output "No prereleases found to cleanup for [$prereleaseName]."
+        return
+    }
+
+    $tagsToDelete = $prereleaseTagsToCleanup -split ',' | Where-Object { -not [string]::IsNullOrWhiteSpace($_) }
+
+    if ($tagsToDelete.Count -eq 0) {
+        Write-Output "No prereleases found to cleanup for [$prereleaseName]."
+        return
+    }
+
+    Write-Output "Found $($tagsToDelete.Count) prereleases to cleanup:"
+    $tagsToDelete | ForEach-Object { Write-Output "  - $_" }
+    Write-Output ''
+
+    foreach ($tag in $tagsToDelete) {
+        Write-Output "Deleting prerelease: [$tag]"
+        if ($whatIf) {
+            Write-Output "WhatIf: gh release delete $tag --cleanup-tag --yes"
+        } else {
+            gh release delete $tag --cleanup-tag --yes
+            if ($LASTEXITCODE -ne 0) {
+                Write-Error "Failed to delete release [$tag]."
+                exit $LASTEXITCODE
+            }
+            Write-Output "Successfully deleted release [$tag]."
+        }
+    }
+
+    Write-Host "::notice::Cleaned up $($tagsToDelete.Count) prerelease(s) for [$prereleaseName]."
+}