Simplify generate-docs preview detection to a single derived flag

Removes the redundant workflow_dispatch/workflow_call 'preview' input --
every current caller already runs on a non-main ref, so
'github.ref != refs/heads/main' alone is sufficient. Computes it once in
a 'Determine preview mode' step and reuses it (steps.mode.outputs.value /
needs.build.outputs.is-preview) instead of repeating the old two-part
expression across 9 conditionals.

Author: odinr

.github/workflows/generate-docs.yml

@@ -2,17 +2,7 @@ name: Generate Docs
 
 on:
   workflow_dispatch:
-    inputs:
-      preview:
-        description: should be preview
-        type: boolean
-        default: false
-  workflow_call: 
-    inputs:
-      preview:
-        description: should be preview
-        type: boolean
-        default: false
+  workflow_call:
 
 permissions:
   contents: read
@@ -28,66 +18,73 @@ jobs:
     runs-on: ubuntu-latest
     outputs:
       preview-path: ${{ steps.preview-path.outputs.value }}
+      is-preview: ${{ steps.mode.outputs.value }}
     steps:
       - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
+      # single source of truth for preview-vs-production, reused by every step below and by deploy
+      - name: Determine preview mode
+        id: mode
+        shell: bash
+        run: echo "value=${{ github.ref != 'refs/heads/main' }}" >> "$GITHUB_OUTPUT"
+
       - name: Determine preview path
-        if: ${{ inputs.preview || github.ref != 'refs/heads/main' }}
+        if: ${{ steps.mode.outputs.value == 'true' }}
         id: preview-path
         shell: bash
         run: echo "value=$(printf '%s' "$GITHUB_REF_NAME" | sed 's#[^A-Za-z0-9._-]#-#g')" >> "$GITHUB_OUTPUT"
 
       - name: Build documentation
-        if: ${{ !inputs.preview && github.ref == 'refs/heads/main' }}
+        if: ${{ steps.mode.outputs.value == 'false' }}
         uses: ./.github/actions/build-docs
 
       - name: Build preview
-        if: ${{ inputs.preview || github.ref != 'refs/heads/main' }}
+        if: ${{ steps.mode.outputs.value == 'true' }}
         uses: ./.github/actions/build-docs
         env:
           VUEPRESS_BASE: /fusion-framework/previews/${{ steps.preview-path.outputs.value }}/
         with:
           upload-artifact: false
 
       - name: Preserve preview output
-        if: ${{ inputs.preview || github.ref != 'refs/heads/main' }}
+        if: ${{ steps.mode.outputs.value == 'true' }}
         shell: bash
         run: |
           mkdir -p "$RUNNER_TEMP/docs-preview"
           cp -R vue-press/dist/. "$RUNNER_TEMP/docs-preview/"
 
       - name: Checkout main
-        if: ${{ inputs.preview || github.ref != 'refs/heads/main' }}
+        if: ${{ steps.mode.outputs.value == 'true' }}
         uses: actions/checkout@v7
         with:
           ref: main
           fetch-depth: 0
 
       - name: Build production documentation
-        if: ${{ inputs.preview || github.ref != 'refs/heads/main' }}
+        if: ${{ steps.mode.outputs.value == 'true' }}
         uses: ./.github/actions/build-docs
         with:
           upload-artifact: false
 
       - name: Add preview to production output
-        if: ${{ inputs.preview || github.ref != 'refs/heads/main' }}
+        if: ${{ steps.mode.outputs.value == 'true' }}
         shell: bash
         run: |
           mkdir -p "vue-press/dist/previews/${{ steps.preview-path.outputs.value }}"
           cp -R "$RUNNER_TEMP/docs-preview/." "vue-press/dist/previews/${{ steps.preview-path.outputs.value }}/"
 
       - name: Upload Pages artifact
-        if: ${{ inputs.preview || github.ref != 'refs/heads/main' }}
+        if: ${{ steps.mode.outputs.value == 'true' }}
         uses: actions/upload-pages-artifact@v4
         with:
           path: ./vue-press/dist
 
   deploy:
     environment:
       name: github-pages
-      url: ${{ (inputs.preview || github.ref != 'refs/heads/main') && format('{0}previews/{1}/', steps.deployment.outputs.page_url, needs.build.outputs.preview-path) || steps.deployment.outputs.page_url }}
+      url: ${{ needs.build.outputs.is-preview == 'true' && format('{0}previews/{1}/', steps.deployment.outputs.page_url, needs.build.outputs.preview-path) || steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     needs: build
     steps:
@@ -96,6 +93,6 @@ jobs:
         uses: actions/deploy-pages@v5
 
       - name: Publish preview URL
-        if: ${{ inputs.preview || github.ref != 'refs/heads/main' }}
+        if: ${{ needs.build.outputs.is-preview == 'true' }}
         shell: bash
         run: echo "### [Open docs preview](${{ steps.deployment.outputs.page_url }}previews/${{ needs.build.outputs.preview-path }}/)" >> "$GITHUB_STEP_SUMMARY"

.github/workflows/next.yml

@@ -88,8 +88,6 @@ jobs:
     needs: release-pkg
     if: needs.release-pkg.outputs.published == 'true'
     uses: ./.github/workflows/generate-docs.yml
-    with:
-      preview: true
     secrets: inherit