# --------------------------------------------------
# 用途：宣告 Calculate Version action 的輸入、輸出與 Docker 執行方式。
# 更新日期：2026/07/11 21:08:44（Asia/Taipei）
# --------------------------------------------------

# action 的顯示名稱。
name: "Calculate Version"

# action 的簡短描述。
description: "計算版本號"

# action 的作者資訊。
author: "Jeffery"

# 宣告可由呼叫端傳入的輸入參數。
inputs:
  # 是否以 beta 模式計算版本，預設關閉。
  is_beta:
    # 參數說明文字。
    description: "是否為 beta 版本"
    # 未提供時預設為 false，讓一般流程走正式版邏輯。
    default: "false"
  # 用於讀取 release 資訊的 token，保留為可選輸入。
  runner_token:
    # 參數說明文字。
    description: "用於讀取 release 的 token"
    # 明確標示不是必填，呼叫端可依環境提供。
    required: false

# 宣告 action 會輸出的結果欄位。
outputs:
  # 將計算後的版本號輸出給後續工作流程使用。
  version:
    # 輸出說明文字。
    description: "計算出的版本號"

# 指定此 action 以 Docker 模式執行。
runs:
  # 透過 Docker image 啟動。
  using: "docker"
  # 使用同目錄下的 Dockerfile 建置映像。
  image: "Dockerfile"
  # 將 Gitea 與呼叫端輸入注入容器環境，供 entrypoint 與 Node 程式讀取。
  env:
    # Gitea 伺服器 URL，供程式組出 API 或資源路徑。
    GITEA_SERVER_URL: ${{ gitea.server_url }}
    # 目前倉庫識別資訊。
    GITEA_REPOSITORY: ${{ gitea.repository }}
    # Gitea token，供程式讀取受保護資源。
    GITEA_TOKEN: ${{ gitea.token }}
    # runner_token 的優先來源是輸入值，其次是 secrets.GITEA_TOKEN，再其次是 secrets.RUNNER_TOKEN。
    RUNNER_TOKEN: ${{ inputs.runner_token || secrets.GITEA_TOKEN || secrets.RUNNER_TOKEN }}
    # 將呼叫端的 beta 設定直接傳入容器。
    IS_BETA: ${{ inputs.is_beta }}