deploy-docs.yml

name: Deploy Documentation

on:
  push:
    branches:
      - main  # 监听主分支推送
  workflow_dispatch:  # 手动触发
  repository_dispatch:
    types: [build_pages]

permissions:
  contents: write

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      # 2. 使用 GH_TOKEN 拉取私有仓库 TROLLSTORE
      - name: Checkout Private TrollScript Repository
        uses: actions/checkout@v4
        with:
          repository: ${{ secrets.TROLLSTORE }}
          token: ${{ secrets.GH_TOKEN }}
          path: TrollScript-Private
          fetch-depth: 0

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: 3.x

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20.x'
          registry-url: 'https://registry.npmjs.org'

      # 3. 生成 API 文档和 NPM 包
      - name: Generate API Documentation and NPM Package
        run: |
          echo "📋 Generating API documentation..."

          if [ -d "TrollScript-Private/JSModulesAPI" ]; then
            # Generate API.md from split module directories
            python3 TrollScript-Private/scripts/generate_api_docs.py TrollScript-Private/JSModulesAPI/zh ./API.md
            python3 TrollScript-Private/scripts/generate_api_docs.py TrollScript-Private/JSModulesAPI/en ./API.en.md
            echo "✅ Generated API.md and API.en.md"

            # Generate NPM Package with auto-incrementing version
            mkdir -p npm

            # 获取当前 NPM 包的最新版本
            CURRENT_VERSION=$(npm view @dompling/trollscript-types version 2>/dev/null || echo "1.0.0")
            echo "📋 Current NPM version: $CURRENT_VERSION"

            # 提取 patch 版本号并递增
            PATCH_VERSION=$(echo $CURRENT_VERSION | cut -d. -f3)
            NEW_PATCH=$((PATCH_VERSION + 1))
            PACKAGE_VERSION="1.0.$NEW_PATCH"
            echo "📋 New version: $PACKAGE_VERSION"

            python3 TrollScript-Private/scripts/generate_npm_package.py TrollScript-Private/JSModulesAPI/zh ./npm $PACKAGE_VERSION
            echo "✅ Generated NPM package (v$PACKAGE_VERSION) in npm/"
          else
            echo "⚠️ JSModulesAPI directory not found"
          fi

      # 检查 API 是否有变化
      - name: Check if API changed
        id: check_api
        run: |
          API_CHANGED="false"

          # Check if API.md exists and has changes
          if [ -f "API.md" ]; then
            # Compare with git to see if there are changes
            if ! git diff --quiet API.md 2>/dev/null; then
              API_CHANGED="true"
            fi
          else
            # If API.md doesn't exist yet, consider it as changed
            API_CHANGED="true"
          fi

          echo "api_changed=$API_CHANGED" >> $GITHUB_OUTPUT
          echo "📋 API changed: $API_CHANGED"

      # 发布 NPM 包（仅在 API 有变化时）
      - name: Publish NPM Package
        if: success() && steps.check_api.outputs.api_changed == 'true'
        continue-on-error: true
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
        run: |
          if [ ! -d "npm" ]; then
             echo "⚠️ Skipping NPM publish: Directory npm/ not found"
             exit 0
          fi

          if [ -z "$NODE_AUTH_TOKEN" ]; then
             echo "⚠️ Skipping NPM publish: NODE_AUTH_TOKEN is empty. Please check if NPM_TOKEN secret is set correctly."
             exit 0
          fi

          cd npm
          echo "📦 Publishing to NPM..."

          # 尝试发布，捕获错误但不中断工作流
          if npm publish --access public 2>&1; then
            echo "✅ Published successfully"
          else
            echo "⚠️ NPM publish failed (version may already exist or token issue)"
            echo "ℹ️ Continuing workflow..."
            exit 0
          fi

      # 4. 复制私有仓库的文件到当前仓库
      - name: Copy files from Private Repository
        run: |
          echo "📋 Starting file sync from private repository..."

          # Sync templates directory
          if [ -d "TrollScript-Private/templates" ]; then
            rm -rf templates
            cp -r TrollScript-Private/templates ./
            echo "✅ Synced templates/"
          else
            echo "⚠️ templates/ not found in private repository"
          fi

          # Sync README.md
          if [ -f "TrollScript-Private/templates/README.md" ]; then
            cp TrollScript-Private/templates/README.md ./
            echo "✅ Synced README.md"
          else
            echo "⚠️ README.md not found in private repository"
          fi

      # 5. 提交更改到当前仓库
      - name: Commit and Push changes
        if: success()
        run: |
          echo "📋 Checking for changes..."

          # Check if there are changes
          if [ -n "$(git status --porcelain)" ]; then
            git config --local user.email "github-actions[bot]@users.noreply.github.com"
            git config --local user.name "github-actions[bot]"

            git add -A
            git commit -m "🔄 Sync from private repository - $(date '+%Y-%m-%d %H:%M:%S')"
            git push

            echo "✅ Changes committed and pushed"
          else
            echo "ℹ️ No changes to commit"
          fi

      - name: Install dependencies
        run: |
          pip install mkdocs-material

      - name: Prepare Workspace
        run: |
          mkdir -p docs
          cp *.md docs/
          cp templates/*.md docs/
          cp templates/API/*.md docs/
          cp -r AppIcon.png docs/
          cp -r images docs/
          cp -r CNAME docs/
          

      - name: Build and Deploy
        run: mkdocs gh-deploy --force