multiavatar 1.0.12

# Release workflow（仅 [publish] 关键字或手动触发才执行）：
#   · push 到 main：普通提交不执行任何 release 动作（不 bump、不打 tag、不出 Release）；
#     提交信息含 "[publish]" 关键字时：bump 版本 + 打 tag + GitHub Release + 发布 crates.io + npm stage publish。
#   · 手动触发（workflow_dispatch）：可指定 minor / major，并可分别勾选是否发布 crates.io / npm。
#   · npm 采用 stage 模式：CI 只把版本推入 npm 暂存区（npm stage publish），
#     正式发布需 maintainer（启用 2FA）在 npmjs.com 包页面或命令行 npm stage promote 确认。
# 版本递增提交带 [skip ci]，避免自身提交再次触发本 workflow。

name: Release

on:
  push:
    branches: [main]
    paths:
      - "src/**"
      - "Cargo.toml"
      - "Cargo.lock"
      - ".github/workflows/release.yml"
  workflow_dispatch:
    inputs:
      version_bump:
        description: "版本递增类型（手动触发时选择；push [publish] 触发时固定为 patch）"
        type: choice
        default: patch
        options:
          - patch
          - minor
          - major
      publish_crates:
        description: "发布 crates.io（需 secret CARGO_REGISTRY_TOKEN）"
        type: boolean
        default: true
      publish_npm:
        description: "npm stage publish（暂存；需 secret NPM_TOKEN，正式发布还需手动 promote）"
        type: boolean
        default: true

permissions:
  contents: write

jobs:
  release:
    runs-on: ubuntu-24.04
    # 门控：只有手动触发，或 push 的最近提交含 "[publish]" 才进入 release 流程
    if: |
      github.event_name == 'workflow_dispatch' ||
      (github.event_name == 'push' && contains(github.event.head_commit.message, '[publish]'))
    steps:
      - uses: actions/checkout@v5
        with:
          fetch-depth: 0

      # ---- 1. 递增版本号（纯 bash，无 heredoc/python，避免引号转义坑）----
      - name: Bump version
        id: next_version
        run: |
          KIND="${{ github.event.inputs.version_bump || 'patch' }}"
          [ -z "$KIND" ] && KIND=patch
          VER="$(grep -m1 '^version' Cargo.toml | cut -d '"' -f2)"
          IFS=. read -r MAJ MIN PAT <<< "$VER"
          if [ "$KIND" = "major" ]; then MAJ=$((MAJ+1)); MIN=0; PAT=0
          elif [ "$KIND" = "minor" ]; then MIN=$((MIN+1)); PAT=0
          else PAT=$((PAT+1)); fi
          NV="$MAJ.$MIN.$PAT"
          sed -i "s/^version = .*/version = \"$NV\"/" Cargo.toml
          # 同步 npm 包版本（单一来源：Cargo.toml）
          if [ -f wasm/package.json ]; then
            sed -i "s/\"version\": \"[^\"]*\"/\"version\": \"$NV\"/" wasm/package.json
          fi
          cargo metadata --no-deps --format-version 1 >/dev/null
          echo "version=$NV" >> "$GITHUB_OUTPUT"

      # ---- 2. 提交版本变更 + 打 tag（[skip ci] 防循环；version 空则跳过）----
      - name: Commit and tag
        if: steps.next_version.outputs.version != ''
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git add Cargo.toml
          git add wasm/package.json 2>/dev/null || true
          # Cargo.lock 被 .gitignore 忽略（库 crate 惯例，不随 checkout 存在）：
          # 存在才 add（cargo metadata 会在本地生成它），不存在则跳过
          git add Cargo.lock 2>/dev/null || true
          git commit -m "release: v${{ steps.next_version.outputs.version }} [skip ci]"
          git tag "v${{ steps.next_version.outputs.version }}"
          git push origin HEAD:main
          git push origin "v${{ steps.next_version.outputs.version }}"

      # ---- 3. 打包校验 + 发布 crates.io / npm ----
      # 发布条件（三者缺一不可）：
      #   ① 对应 secret（CARGO_REGISTRY_TOKEN / NPM_TOKEN）已配置；
      #   ② 手动触发（workflow_dispatch）且勾选对应开关；
      #      或 push 触发且最近提交信息含 "[publish]" 关键字（两个仓库同时发）；
      #   ③ cargo package 校验通过（crates.io 步骤天然保证）。
      - name: Package verify
        run: cargo package --allow-dirty

      - name: Publish to crates.io
        env:
          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
        run: cargo publish --registry crates-io
        if: |
          env.CARGO_REGISTRY_TOKEN != '' &&
          (
            (github.event_name == 'workflow_dispatch' && github.event.inputs.publish_crates == 'true') ||
            (github.event_name == 'push' && contains(github.event.head_commit.message, '[publish]'))
          )

      # npm 包（stage 模式）：wasm/package.json 版本已由 Bump 步骤同步。
      # npm stage publish 是 npm 12+ 命令（npmjs 2026 新发布流程），CI 镜像自带 npm 10/11 没有，
      # 故用 npx npm@12 显式调用；prepublishOnly（node 同步脚本）幂等无害。
      # stage 发布后需 maintainer（2FA）promote 才正式可见：
      #   网页：https://www.npmjs.com/package/@w916797724/multiavatar → Staged releases → Approve
      #   命令行：npm stage promote --package @w916797724/multiavatar --version <版本>
      - name: Stage npm package
        working-directory: wasm
        env:
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
        run: |
          npm config set //registry.npmjs.org/:_authToken "${NPM_TOKEN}"
          npx -y npm@12 stage publish --registry https://registry.npmjs.org
        if: |
          env.NPM_TOKEN != '' &&
          (
            (github.event_name == 'workflow_dispatch' && github.event.inputs.publish_npm == 'true') ||
            (github.event_name == 'push' && contains(github.event.head_commit.message, '[publish]'))
          )

      # ---- 4. 构建可运行 demo 二进制并打 Release（附 .crate 源码包）----
      # 注意：不带 --locked——Cargo.lock 被 .gitignore 忽略，CI 检出时不存在
      - name: Build demo binary
        run: cargo build --release --example demo

      - name: Create GitHub Release
        env:
          GH_TOKEN: ${{ github.token }}
        run: |
          gh release create "v${{ steps.next_version.outputs.version }}" \
            --repo "${{ github.repository }}" \
            --title "v${{ steps.next_version.outputs.version }}" \
            --generate-notes \
            target/package/multiavatar-*.crate \
            target/release/examples/demo